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* * * H T I C E * * * 

***LIMITEO WARRANTY*** 

MISOSYS shall have no liability or responsibility to the purchaser or 
any other person, company, or entity with respect to any liability, loss, or 
damage caused or alleged to have been caused by this product, Including but 
not limited to any interruption of service, loss of business and anticipatory 
profits, or consequential damages resulting from the operation or use of this 
program. 

Should this program recording or recording media prove to be defective 
in manufacture, labeling, or packaging, MISCC .1 will replace the program upon 
return of the program package to MISOSYS within 90 days of -the date of 
purchase. Except for this replacement policy, the sale or subsequent use of - 
this program material 1s without warranty or liability. v 

***HARNIN6*** 

This program package is copyrighted with all rights reserved. The 
distribution and sale of this program 1s intended for the personal use of the 
original purchaser only and for use only on the computer system noted herein. 
Furthermore, copying, duplicating, selling, or otherwise distributing this 
product is expressly forbidden. In accepting this product, the purchaser 
recognizes and accepts this agreement. 

MISOSYS 
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Preface 

EDAS 1s an evolutionary product. It has been designed to provide many 
useful assembler capabilities for the most discriminating programmer while at 
the same time, Its command syntax and ease of use provide for an excellent 
assembler language development tool for the programmer from beginner through 
advanced level. Its editing syntax has been implemented to appear Identical 
to that found 1n the '80s BASIC interpreter so as to provide a high degree of 
familiarity and minimal training requirements. 

Although considerable effort was expended to make the user reference 
manual as complete as possible, this documentation package 1n no way 1s to be 
considered an Instructive guide into the writing of Z-80 source programs. 
Many reference texts are available that deal with learning and Improving your 
abilities to program In assembly language. If you are Teaming assembly 
language, your reference materials should Include at least one of the many 
good texts on thf market, an asortment of periodicals, and a good 
disassembler. 

My advice 1s to peruse the contents of this reference manual to 
familiarize yourself with its Information and the Editor Assemblers 
capabilities as well as the Utility Applications included on the distribution 
diskette. If you have any questions concerning this application, feel free to 
call or write; however, be prepared to give your EDAS registration number. It 
would also be helpful to make sure your questions are not answered 1n the 
manual. 

Speaking of registrations, MISOSYS would like to provide you with the 
best technical support possible. To provide this support, we need to know who 
our customers are. So please fill out the registration form packaged with the 
diskette and return 1t to us promptly - postal card postage 1s sufficient. 
The registration number located on the diskette iabel must be entered onto 
the registration card and should also be entered in the space provided below. 
The registration number must be mentioned on all correspond ance with us or 
when telephoning for service, so don't lose 1t. Thank you. 
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DISTRIBUTION DISKS 



The Model I/III EDAS IV version and each of its utilities, are single 
programs that work on both the Model I and III under LDOS. It is distributed 
on a 35 track single density data diskette. The LDOS 6.x EDAS Version IV is 
distributed on a 40 track double density data diskette. The Model II Version 
is distributed on an 8 Inch diskette. 

It is strongly recommended that before using your new Editor Assembler, 
you should make a BACKUP copy to use in a working environment and retain the 
EDAS diskette as your MASTER copy. This "master" should be backed up to 
produce a "working" copy and the "master" archived. The BACKUP* uti 1 i ty 
procedures are found in your DOS Owner's Manual in the section entitled 
"UTILITY PROGRAMS". After creating a BACKUP copy of the EDAS diskette, store 
the MASTER diskette in a safe place. Use only your "working" copy for 
production. 

THE EDAS FACILITY 

The MISOSYS Editor Assembler is a RAM-resident text editor and RAM 
resident or direct disk assembler for the Model I, II, and III microcomputer 
systems, as well as computers running under LDOS 6.x. The Editor Assembler 
was designed to provide the maximum in user interface and ease of use while 
providing capabilities powerful enough for the expert Z-80 assembly language 
programmer .- 

The text editing features, of the Editor Assembler facilitate the 
manipulation of alphanumeric text files for both assembler source and 
compiler source languages. The most common use of the editing capability is 
in the creation and maintenance of assembly language source programs to be 
assembled by EDAS. Through full support of upper and lower case text entry, 
the Editor can serve as a line-oriented text processing tool. 

The assembler portion of the Editor Assembler facilitates the 
translation of Z-80 symbolic language source code programs into machine 
executable code. This object code may then be executed directly from the DOS 
Ready prompt. 

Although EDAS could be used as an entry-level assembler, the scope of 
the documentation assumes a previous knowledge of assembler language and the 
hexadecimal number system. This is not a "learning" manual - it details the 
use of EDAS Version IV but in no way attempts to teach you how to program in 
the Z-80 assembly language. You should have available a standard reference 
handbook on the Z-80 code. Many texts are available. 

The <A>ssemble command supports the assembler language specifications 
set forth in the ZILOG "Z80-ASSEM8LY LANGUAGE PROGRAM MANUAL", 3.0 D.S., 
REL.2.1, FEB 1977, with certain limitations. 
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Nested MACROS are supported; however, MACROS must be defined 
individually. J 

Operand expressions may contain the "+", "-", "*", "/", ".MOD.", "&*' or 
".AND." (logical AND), "I" or ".OR." (logical OR), ".XOR." (logical XOR), 
.NOT. (logical ones complement), .NE. and .EQ. (logical comparison, and "<" 
(shift) operators, and are evaluated on a strictly left to right basis. 
Parentheses are not allowed! 

Conditional assembly commands, where a programmer may control which 
portions of the source code are assembled, are implemented with the 
conditional pseudo-ops; IF, IFLT, IFEQ, IFGT, IFNE, IFLTS, IFEQ$, IF6T$. 
IFNES, IFDEF, IFNDEF, and IFREF. h 

Constants may be decimal (D), hexadecimal (H), octal (0) or (Q), binary 
(B), or string ('cc'). 

The Assembler commands supported are *UST OFF, *UST ON, *M0DULE, 
*PREFIX, *6ET filespec, and *SEARCH library, as well as a range of listing 
pseudo-ops (TITLE, SUBTTL, SPACE, PASE, and constant declarations for bytes, 
words, and strings). 

A label can contain only alphanumeric characters and certain special 
characters. A label can be up to 15 characters long. The first character must 
be alphabetic (A-Z), the dollar sign ($) or the <AT> sign (§). Subsequent 
characters must be alphanumeric (A-Z, 0-9) or selected special, characters - 
<AT> sign (@), underline ( ), question mark (?) or dollar sign ($). For / 
compatibility with MACRQ-80, """a colon maybe inserted immediately following 
the symbol. 

Two utilities are included with the EDAS application. XREF/CMD is used 
to generate a full cross reference listing of symbol use. TTD/CMD is a tool 
to convert EDTASM compatible source cassette files to EDAS source disk files. 

NOTATION CONVENTIONS 
Braces •■<}■ 

Braces enclose optional information. The braces are never input in 
Editor Assembler commands (Note: braces are used 1n C language source code). 

Ellipses "..." 

The ellipses represents repetition of a previous item. 
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A Line number "line" 



"line" represents a number arbitrarily assigned to a statement for the 
purpose of identifying it to the editor functions. "Line" can be any decimal 
number ranging from <1 - 65529>. 



Period 



M H 



A period may be used in place of any line number. It represents a 
pointer to the current line of source code being assembled, printed, or 
edited. It is termed the "current line pointer" throughout^ this 
documentation. 

Top of Text "#" or "t" 



The pound sign character,"*", or the letter "t", may be used in place of 
any line number during a line number reference. It represents the beginning 
or top of the text buffer. * 

Bottom of Text "*" or "b" 



The asterisk character, "*", or the letter "b", may be used in place of 
any line number during a line number reference. It represents the bottom of 
the text buffer. 

Line Increment "inc" 



This is a number representing an increment between successive line 
numbers. 

LOWER CASE ENTRY 

xsMnuuasdu 

Lower case is supported freely throughout EDAS for text and command 
entry. All Editor Assembler commands may be entered in lower case as well as 
upper case to facilitate its use as a general purpose text editor. 

Assembler source code can be entered in upper case or lower case. For 
lower case entry, the Editor must be in the case converted mode (see the 
<S>witch case command). This mode automatically converts lower case entry to 
upper case except for text which is between single quotes (enabling lower 
case string constants) and for all text following a semicolon (permitting 
lower case comments). 
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EXECUTING EDAS 



EDAS is a directly executable command file. It is accessed in response 
to the DOS command prompt simply by entering: 



EDAS (MEM»val ,JCL,ABORT,LC,EXT»"ext",Pn«val ) 
EDAS * 

MEM»val is used to protect a high memory region just 

like you can in BASIC. 

JCL 1s used when running from Job Control Language 

so that EDAS uses the GKEYIN routine for its 
keyboard input. 

ABORT if specified, EDAS will automatically abort 

after an assembly with errors. It will return 
to DOS Ready. 

LC 1s used when editing LC source files. It will 

set tabs to 4, default extension to "CCC", and 
Invoke "lower case permitted". 

ECT" a ext" provides a means by which the default source 
- file extension can be altered to "ext". 

Pn»val can be used to pass symbol equates to the 

assembler from the command line, "n" can range 
from <l-4> permitting four symbol equates. 



h 



* 1f specified, will reload EDAS and maintain 

the text buffer pointers. 

Note: "val" can be entered as parm-ddd or parm»X'hhhh'. 

There are no parameter abbreviations. 



The parameters shown in parentheses are entirely optional. They are used 

to alter the behavior of EDAS. Parameters enhance the utility of the Editor 

Assembler by giving 1t greater flexibility. These options are used as 
follows: 

MEM»val 



This parameter is "used to protect a high region of memory from use by 
EDAS. The region would usually be reserved for an 1n-memory assembly. 
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If you do not enter a value, EDAS will recover the value stored at HIGH$ ^ 
(address X'4049' and X'404A' for the Model I or X'4411' and X'4412' for the 
Model III) or use the value returned by the DOS (for the Model II or LDOS 
6.x) and use it for top of memory, maintaining its MEMTOP pointer to that 
value. If you do not wish to protect any memory from use by the Editor 
Assembler, do not use this parameter. 

You may protect a memory region similar to that which can be protected 
from BASIC by entering a non-zero value. Enter an address value in decimal or 
hexadecimal which is one byte less than the lowest address you want to 
protect. Your entry must be greater than the start of the text buffer. At no 
time will the Editor Assembler use memory higher than the entered value. This** 
function is useful if you have placed a high memory driver or utility program 
that does not maintain HISH$ and you want to avoid clobbering it. For 
example: 

EDAS (MEM=X'DFFF') 

will restrict EDAS from using any address ' above X'DFFF'. Your in-memory 
program can be assembled starting at address X ' E000 ' . 

JCL (LDOS use only) 

EDAS uses an internal line input routine to enable the parsing of 
certain characters. This hinders the ability of commanding EDAS from within S 
the Job Control Language (JCL) of LDOS. If you want to control the assembly 
process from JCL, use the JCL parameter in the EDAS command line. If you are 
going to <I>nsert text while in a JCL mode, then you must use the M X01" to 
simulate a <BREAK> in the JCL file. Don't forget, the "XQl" can only be used 
if you are going to compile the JCL. For example, the following enters EDAS 
and inserts one line: 

edas (jcl) 

i 

This is a test 

//stop 
ABORT 

. This parameter will cause EDAS to abort and return to DOS upon an 
assembly or disk error, or one of the following errors: no text in buffer, 
line number too large, bad parameters, buffer full, no such line, *GET or 
*SEARCH error, *SEARCH file not a PDS, PDS member error. . It is useful when 
running from a Job Control Language to inhibit erroneous jobs from 
continuing. 



^ 
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This parameter is used when you are editing LC source files (C 
language). It will do three things for you. LC changes the source file 
default extension from "ASM" to "CCC" - "CCC" is used in the LC compiler. It 
will change the tab stops from every eight columns to every four columns - 
more reasonable for LC source code. The LC parameter will also invoke the 
<S>witch case command to "lower case permitted" as LC source code is entered 
primarily in lower case. 



EXT»"ext* 



<*-} 



This parameter is available for those using the EDAS editor to edit and 
maintain files other than EDAS assembler source files. For instance, the M-80 
assembler uses "MAC" as the standard extension. FORTRAN uses "FOR". You may 
be using EDAS to create or edit JCL files. Use this parameter to change the 
default source file extension (that used with the <L>oad and <W>rite 
commands) to one of your choice. You must enter a full three characters if 
you use this parameter. For example: 

EDAS (EXT«"MAC") 

specifies that "MAC" be used as the default extension (make sure the supplied 
extension 1s entered in UPPER CASE). 

Note that the override of "CCC" if the LC parameter is used takes 
precedence. If LC is specified, the EXT* parameter is ignored. 

Pn»val 



the power of entering symbol table equates 



EDAS command line. "Pn" is actually four parameters as "n" 



This parameter provides 
directly from the 

can range from <l-4>. Thus, you specify the parameter as either PI, P2, P3, 

or P4. These parameters are EDAS entry symbol table additions. By passing 

parameter values with these on the EDAS command line, you can alter four 
symbol table entries. Thus, you can use these to control EQUate options, pass 

values to symbols, etc. The format usable is: 



Pn sets @@n to TRUE. 

Pn*ddd sets @@n to decimal value ddd. 

Pn»X'hhhh' sets @@n to hexadecimal, value hhhh. 

UHIiaHSaiU333SSSSSaK333a3SSX3SX3I«33S:»:»3IX333a33»»S 
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The actual labels added to the symbol table as DEFLs are M @@n", where 
"n" is the same as the "n" of "Pn M . This is depicted as follows: 

I • I 

| PI ** mi P2 == @@2 P3 «» mi P4 «* @@4 I 



The four symbols initially have a value of zero (logical FALSE). You can 
use these to externally set flags for use in conditional assembly (or 
whatever else your heart desires). For example, say you have a program that 
uses two conditional symbols, MODI and MQD3. If your program has tne 
statements: 

MODI EQU 991 
M0D3 EQU @@3 

then an EDAS command line of EDAS (PI) will set "@@1" to TRUE, "@@3" was 
defaulted to FALSE, and thus ^MQDl 83 would be TRUE and B MOD3 ts would be FALSE 
Since the two conditional symbols you are using are equated to the "©©n" 
parameters. 

You will find this parameter support a great feature when running EDAS 
from JCL. ~^ 

EDAS * y 

The "EDAS *" is used to re-enter EDAS keeping the source program and 
variables intact. This permits you to recover after a re-boot providing the 
Editor Assembler region is not disturbed or in case you inadvertantly entered 
the <B>ranch command without saving your source file. The region occupied by 
the Editor Assembler is not normally disturbed by a RESET and boot of DOS. 
Remember to hold the <ENTER> key depressed during the RESET operation 1f your 
SYSTEM diskette contains an AUTO function. 

EDAS COMMAND MODE 

Once "EDAS* is entered, the following message will appear on the video 
display screen: 

MISOSYS EDAS-n.n 

The "n.n" is indicative of the current version number. This display is 
followed by a right caret ->'» prompt. The prompting character is displayed 
whenever EDAS 1s ready to accept a command. Detailed information on all 
commands supported can be found in the chapter entitled, COMMANDS. 
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SYNTAX 
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The basic format of an assembly language statement consists of up to 
four fields of information. These fields, in order, are: 



isiiuiu 



>> 



{LABEL} {OPCODE} {0PERAND{S}} {;C0MMENT} 

LABEL 1s a symbolic name assigned the address value 

of the first byte of the object instruction. K? 

OPCODE 1s the mnemonic of a specific Z-80 assembler 

Instruction or pseudo-OPeration code. 

OPERANDS are arguments of the OPCODE. 

;C0MMENT is an informative notation that is ignored by 
the assembler but aids in documenting the 
source code. 

I Note: Fields are separated by a tab or spaces. 

Miirasuaiatau>s»uuuuuiiiiBMinui»aut»Mii»tis*it 

As can be noted from the format box, none of the fields are required; 
however, each line should contain at least one field. This may seem unusual 
at first, but 1t 1s readily explained. If you want the comment field to 
occupy the entire line, start the line with a semi -col on in the first 
character position of the line - then, no other field is needed. A symbolic 
label can exist by itself on a line. There are some Z-80 operation codes that 
have no arguments; thus, an OPCODE could exist by itself on a line (in field 
2). You will never have an argument by Itself as an argument relates to an 
OPCODE. 

The statement line is considered to be freely formatted. That means that 
there are no columnar restrictions. Fields are separated by one or more tabs 
or spaces. If a tab 1s used, 1t makes for neater listings. Tabs are also 
retained as tabs and thus will keep source files smaller than using multiple 
spaces. 

Symbolic Labels 

A label is a symbolic name of a line of code. Labels are always 
optional. A label is a string of characters no greater than 15 characters. 
The first character must be a letter (A-Z) or one of the special characters, 
«$'• and m Q*. The "@" as the first character of a label is useful for 
highlighting certain labels since labels begining with "@" appear at the 
beginning of an ascendingly sorted list (such as the symbol table listing or 
cross-reference l!f tin9 l* Th ?, d ° llar sign is supported for easier adaptation 
of M-80 source files. Actually, the "$'* sorts out higher than u §"; however, 
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it is recommended that you reserve use of "$" as the first character, of 
"local" labels. This can be very useful in light of the "-SL" assemble switch 

A label may contain, within character positions 2-15, letters (A-Z), 
decimal digits (0-9), or certain special characters: the <AT> sign, l, @"; the 
underline, "__"; the question mark, "?"; or the dollar sign, "$". The dollar 
sign "$ tt , appearing by itself, is reserved for the value of the reference 
counter of the current instruction. It cannot be used as a single character 
symbol . 

A symbol appearing by itself in the LABEL field of a line, will be 
interpreted as being equated to the current value of the program counter. 
Thus, the following two LABEL examples are completely equivalent: *? 

ALLALONE 
ALLALONE EQU $ 

Certain labels are reserved by the assembler for use in referring to 

registers. Others are reserved for branching conditions (condition codes) and 

isjgy not be used for labels, (these conditions spply to status flags). The 
following labels are reserved and may not be used for other purposes: 



I Reserved Labels 

I A, B, C, D, E, H, L, I, R, 

I IX, IY, SP, AF, BC, DE, HL 

I C, NC, Z, NZ, M, P, PE, PO 

I AND, EQ, MOD, NE, NOT, OFF, ON, OR, XOR 

Examples of labels: 

m •» <a» «n «* m «w <k» «•«*>«» mm «■> m «■> m *mm <m 

ENTRY @OPEN BUFFERS BYTE POINTER WHAT? 
SELECT.CODE $$C0RE @ CARRTaGE_RETURN SEXIT 

Opcodes . 

The OPCODES for the EDAS Version IV Assembler correspond to those in the 
Z-80-ASSEMBLY LANGUAGE PROGRAMMING MANUAL, 3.0 D.S., REL 2.1, FEB 1977. 

Operands 

Operands are always one or two values separated by commas. Some 
instructions may have no operands at all. 



INFO - SYNTAX 
3-2 



> 



Assembly Language Information 



A value in parentheses "()" specifies indirect addressing when used with 
registers, or "contents of" otherwise. 

Constants are data declarations of fixed value. They are constructed as 
a sequence of one or more digits and an optional radix specification 
character. The digits must be valid for the radix used. The following table 
denotes aceptable constant composition: 

iasaMisassas3>ssasuai*isss»3a8»sxsssss»asxissasxMsa«>»a(i 



Data Type Radix Char Digits 

hexadecimal H <0-9,A-F> 

decimal D <0-9> 

octal or Q <0-7> 

binary B <0-l> 



Examples 

1AH, 0ABH, 0FFH 

107D, 107, 15384 

166Q, 1660 

01101110B 



p 



I 



*>- 



Note: Decimal is assumed if the radix character is omitted j 

I 

aaaasaaaaaaaaaaaaaaaaaasaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 

A constant not followed by one of the radix characters is assumed to be 
decimal. A constant must begin with a decimal digit. Thus "FFH" is not 
permitted, while "0FFH" Is valid. 

Operands may also be constructed as complicated expressions using the 
mathematical and logical operators. Due to the extent of the documentation, 
they are described in the section on "Expressions". 



Comments 



H.N 

» 



All comments must begin with a semicolon 
starts with a semicolon in the first character 
entire line is a comment. If EDAS is in the 
comments will be retained in whatever case they 



. If a source statement line 

position of the line, the 

lower case converted mode, 

are entered. It is suggested 



that comments be entered in lower case with punctuation as required. It will 
make your source code listings much easier to read. All entry of text 
following a semi-colon is maintained in its entered case. 
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EXPRESSIONS 



mmmmmmmmmma 



A value of an operand may be an expression consisting of multiple terms 
(labels and data constants) connected with mathematical operators. These 
expressions are evaluated in strictly LEFT to RIGHT order. No parentheses are 
allowed. EDAS does not support operator precedence. Most operators are 
binary, which means that they require two arguments. Both "+" and "-" have 
unary uses also. The following operators are supported: 



I OPERATOR 


FUNCTION 


EXAMPLE | 


I *»«••«»«»«*>«■«»«* 


——==——»«.•«,„•.„«.«,„ 


.—................ | 


i ♦ 


Addition 


ALPHA + BETA | 


1 


Subtraction 


ALPHA - BETA | 


i "k 


Multiplication 


ALPHA * BETA | 


1 / 


Division 


ALPHA / BETA | 


I .MOO. 


Modulo Division 


ALPHA .MOD. BETA" | 


I < 


Shift Left or Right 


ALPHA < -BETA | 


1 .AND. or & 


Logical Bitwise ANO 


ALPHA .AND. BETA | 


1 .OR. or ! 


Logical Bitwise OR 


ALPHA .OR. BETA | 


1 .XOR. 


Logical Exclusive OR 


ALPHA .XOR. BETA | 


1 .NOT. 


Logical l's Complement 


FALSE EQU .NOT. TRUE | 


1 .NE. 


Logical Binary Not Equal 


ALPHA .NE. BETA | 


1 .EQ. 


Logical Binary Equal 


ALPHA .EQ. BETA | 


1 % 


Length of MACRO 


%#LABEL or %% | 


1 U 


MACRO label concatenation 


#NAMEX&L | 

uuuuiusigtitiuiii 


Addition (+) 







y»-j 



"N 



y 



The addition operator will add two constants and/or symbolic values. 
When used as a unary operator, it simply echoes the value. 
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Examples: 


CON30 


EQU 






001E 


30 




(9010 


C0N16 


EQU 


+10H 




0003 


C0N3 


EQU 


3 




002E 


A2 


EQU 


CON30+CON16 




Subtraction (-) 









*1 



The minus operator will subtract two constants and/or symbolic values. 
Unary minus produces a 2's complement. 

Examples: 



000E A2 EQU CON30-CON16 

FFF2 A4 EQU -A2 

Multiplication (*) 



The multiplication operator will perform an Integer multiplication of a 
16-bit multiplicand by an 16-bit multiplier. Overflow of the resulting 16-bit 
value Is not flagged as an error. 



Examples: 



01E0 


A5 


EQU 


BF20 


A6 


EQU 


Division (/) 







CON30*CON16 

60000*3 ;this overflows 



The division operator will perform an Integer division of a 16-bit 
dividend by an 8-bit divisor. 

Examples: 



0002 


A7 


EQU 


5/2 


1B40 


A8 


EQU 


48928/7 






s 
* 


IHFQ - EXPRESSIONS 

3-5 



Assembly Language Information 

Modulo (.MOO.) 

The modulo operator calculates the remainder of the above integer 
division. 

Examples: 



0001 


A9 


EQU 


5. MOD. 2 


0005 


A10 


EQU 


48928. MOD. 7 


Shift «) 









*>■■} 



This operator can be used to shift a value left or right. The form is: 



I VALUE < MAMOUNT I 

I I 

If AMOUNT is positive. VALUE is shifted left. If AMOUNT is negative, 
VALUE is shifted right. The magnitude of the shift 1s determined from the 
numeric value of AMOUNT. A good use of the SHIFT operator 1s to determine the 
high order byte value of a 16-bit value. 

Examples: 



0057 


HIORD EQU 


5739H<~8 


C000 


Al 


EQU 


3C00H<4 


03C0 


A2 


EQU 


3C00H<-4 


BBFF 


A3 


EQU 


3CBBH<8+255 


03C0 


A3 


EQU 


15+3C00H<-4 


The next 


higher | 


page address in a proi 


CORE 


DEFL 
ORG 


$<-8+l<8 
CORE 


cal AND (.AND. or 


&) 





The logical AND operator bitwise ANDS two constants and/or symbolic 
values. Each bit position of the 16-bit resultant value is a "1" only if both 
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arguments have a "1" in the corresponding position, or a "0" if either 
argument has a "0". 

Examples: 



3C00 


Al 


EQU 


3C00H&0FFH 


0000 


A2 


EQU 


0&15 


0000 


A3 


EQU 


0AAAAH.AND.5555H 



Logical OR (.OR. or i) 



v*7 



The logical OR operator bitwise "ORS" two constants and/or symbolic 

values. Each bit position of the 16-bit resultant value is a "1" if either 

argument has a "1" in the corresponding position, or a "0" if neither 
argument has a "1". 

Examples: 



3CFF 


Al 


EQU 


3C00HI0FFH 


000F' 


A2 


EQU 


0.OR.15 


FFFF- 


A3 


EQU 


0AAAAH.OR.5555H 



Logical XOR (.XOR.) 



The logical XOR operator performs a bitwise exclusive OR on two 
constants and/or symbolic values. Each bit position of the 16-bit resultant 
value is a "1" only if both arguments have reversed bits in the corresponding 
position (i.e. one must have a "1 M while the other must have a "0"). The XOR 
operation is considered a modulo two addition. 

Examples: 



3CF8 


Al 


EQU 


3C07H.XOR.0FFH 


0007 


A2 


EQU 


8. XOR. 15 


FFFF 


A3 


EQU 


0AAAAH. XOR. 5555 H 



Logical NOT (.NOT.) 



This is a unary operator. It performs a one's complement on the term it 
precedes. Observe the following examples: 
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FFFE 


Tl 


EQU 


.NOT.l 


FFFF 


T2 


EQU 


*MGT«0 


0000 


T3 


EQU 


.NOT.-l 



Logical NOT-EQUAL (.NE.) 

This operator is a binary operator that compares two adjacent terms. The 

resultant value is TRUE if the terms are not equal. A FALSE result is 

returned if the two terms are equal. Observe the following examples: 



0000 


Tl 


EQU 


1000. NE. 1000 


FFFF 


T2 


EQU 


1000. NE. 10 


FFFF 


T3 


EQU 


l.NE.-l 


0000 


T4 


EQU 


.NOT.0.NE.-1 



St, 



Logical EQUAL (.EQ.) 

This operator 1s a binary operator that compares two adjacent terms. The 
resultant value is TRUE 1f the terms are equal. A FALSE result 1s returned 1f 
the two terms are not equal. Observe the following examples: 

FFFF Tl EQU 1000. EQ. 1000 

0000 Tl EQU 1000. EQ. 10 - -n 

0000 T3 EQU l.EQ.-l 

FFFF T4 EQU .NOT.0.EQ.-1 F 

Macro Length Operator {%) 

The length operator is applicable only with MACRO usage. Therefore, its 
use will be discussed in the chapter on MACRO PROCESSING. 
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Z-80 STATUS INDICATORS (FLA6S) 

lUMHHIHIHHItlUUIUIH 

The flag registers (F and F') supply Information to the user regarding 
the status of the Z-80 at any given time. The bit positions for each flag are 
as follows: 

saaauxacasasssasssssaiMsassassaasssaisasuaaaxasiiasssiiaiaias 



7 


6 


5 


4 


3 2 1 





S 


Z 


X 


H 


X P/V N 


C 



Z 1s the Zero flag. 
S 1s the Sign flag. 
X 1s not used. 



*t 



C 1s the Carry flag. 

N Is the Add/Subtract flag. 

P/V 1s the Parity/Overflow flag. 

H 1s the Half -carry flag. 

aaaaaaaaaasxsaaasaaaaaaaassaaaaaaaaaaaaaaaaaasssaaassaaaaasaxaa 

Each of the two Z-80 flag registers contain six (6) bits of status 
information which are set or reset by CPU operations. Four of these bits are 
testable (C, P/V, Z, and S) for use with conditional jump, call, or return 
Instructions, Two flags (H, N) are not directly testable and are used by the 
Z-80 Internally to handle Binary Coded Decimal (BCD) arithmetic. Two flag 
register bits (3, 5) are not used by the Z-80. 



In the Z-80 mnemonic instruction set, the "CALL 1 



•JP 1 



and »JR' 



instructions can contain a "condition code" which is part of the argument of 
the OPCODE. The branching determination 1s performed according to the result 
of the flag register testable bits. The mnemonics for these condition codes 
are as follows: 



FLAG 


CONDITION SET 


CONDITION NOT SET | 


Carry 


C 


NC | 


Zero 


Z 


NZ | 


Sign 


M (minus) 


P (plus) | 


Parity 


PE (even) 


PO (odd) | 



tast333asasxc3i3(S3as3s33sacx33t3ca8ESE3taasaaas3333^: 
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Carry Flag (C) 



This flag is set to a particular state depending on the operation being 
performed. For arithmetic operations, this flag Indicates an overflow 
condition when the Accumulator result is greater than the maximum possible 
number (+127) or is less than the minimum possible number (-128). The 
overflow condition 1s determined by examining the sign bits of the operands. 

For addition, operands with different signs will never cause overflow. 
When adding operands with like signs and the result has a different sign, the 
overflow flag is set. For example: 

+120 ■ 0111 1000 ADDEND 
+105 « 0110 1001 AUGEND 



+225 * 1110 0001 (-95) SUM 
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The carry flag is set or reset depending on the operation being 
performed. For "ADD" instructions that generate a carry and "SUBTRACT" 
instructions that generate a borrow, the carry flag will be set. The carry 
flag 1s reset tiy an "ADD" that does not generate a carry and a "SUBTRACT" 
that generates no borrow. This saved carry facilitates software routines for 
extended precision arithmetic. Also, the "DAA" instruction will set the carry 
flag if the conditions for making the decimal adjustment are met. 

For instructions RLA, RRA, RlS, and RRS, the carry bit 1s used as a link 

between the least significant bit (LSB) and most significant bit (MSB) fqr^ 
any register or memory location. During instructions RLCA, RLG s and SLA s, 

the carry contains the last value shifted out of Bit 7 of any register or 

memory location. During instructions RRCA, RRC s, SRA s, and SRL s, the carry 

contains the last value shifted out of Bit of any register or memory 
location. 

For the logical instructions AND s, OR s, and XOR s, the carry flag will 
be reset. The carry flag can also be set (3D-) or complemented (CCF). 

Add/Subtract Flag (N) 

This flag is used by the decimal adjust accumulator Instruction (DAA) to " v 
distinguish between "ADD" and "SUBTRACT" Instructions. For all "ADD" 
instructions, "N" will be set to a "zero". For all "SUBTRACT" Instuctlons, r 
"N" will be set to a "one". 

Parity/Overflow Flag (P/0) 
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The two numbers added together have resulted in a number that exceeds +127 
and the two positive operands have resulted in a negative number (-95) which 
is incorrect. The overflow flag 1s therefore set. 

For subtraction, overflow can occur for operands of unlike signs. 
Operands of like sign will never cause overflow. For example: 



+127 
(-)-64 



0111 1111 
1100 0000 



MINUEND 
SUBTRAHEND 



+191 - 1011 Ull 



DIFFERENCE 



The minuend sign has changed from a positive to a negative gking an 
Incorrect difference. The overflow flag is therefore set. Another method for 
predicting an overflow 1s to observe the carry into and out of the sign bit. 
If there 1s a carry 1n and no carry out, or 1f there 1s no carry 1n and a 
carry out, then overflow has occurred. 

This flag is used with logical operations and rotate Instructions to 
indicate the parity of the result. The number of "one" bits in a byte are 
counted. If the total is odd, "ODD" parity (P=0) is flagged. If the total 1s 
even, "EVEN" parity is flagged (P=l). When inputting a byte from an I/O 
device "IN r,(C)\ the flag will Indicate the parity of the data. 

During search Instructions (CPI, CPIR, CPD, and CPDR) and block transfer 
instructions (LDI, LDIR, LDD, and LDDR), the P/V flag monitors the state of 
the byte count register (BC), When decrementing the byte counter results 1n a 
zero value, the flag 1s reset to zero, otherwise the flag 1s a one. 

During "LD A,I" and "LD A,R" instructions, the P/V flag will be set with 
the contents of the interrupt enable flip-flop (IFF2) for storage or testing. 

The Half Carry Flag (H) 



The half carry flag (H) will be set or reset depending on the carry and 
borrow status between bits 3 and 4 of an 8-bit arithmetic operation. This 
flag is used by the decimal adjust accumulator Instruction (DAA) to correct 
the result of a packed BCD add or subtract operation. The "H" flag will be 
set (1) or reset (0) according to the following table: 



H 

1 



ADD 

There is a carry from 
Bit 3 to Bit 4 

There is no carry 
from Bit 3 to Bit 4 



SUBTRACT 

There 1s no borrow 
from. Bit 4 

There is a borrow 
from Bit 4 



I»3H3IS»X» 



3SnSSS33SSSS3333S3Xa33a3ai3S33SXX333aSS3S3S 



INFO - FLASS 

3-11 



Assembly Language Infonnatloii 

The Zero Flag (Z) > 

The Zero flag (Z) is set or reset if the result generated by the 
execution of a certain instruction is a zero. For 8-bit arithmetic and 
logical operations, the "Z" flag will be set to a "one" if the resulting byte 
in the Accumulator is zero. 

For compare (search) instructions, the "Z" flag will be set to a "one" 
if a comparison is found between the value in the Accumulator and the memory 
location pointed to by the contents of the register pair HL. 

When testing a bit in a register pr memory location, the "Z" flag will 
contain the state of the Indicated bit. *"* 

When inputing or outputing a byte between a memory location and an I/O 
device (INI, INO, OUTI, or OUTD), if the result of register B minus one (1) 
is zero, the Z flag 1s set, otherwise 1t 1s reset. Also for byte inputs from 
I/O devices using "IN r,(C) M , the Z flag 1s set to Indicate a zero byte 
Input. 

The Sign Flag (S) 

The Sign flag (S) stores the state of the most significant bit of the 
accumulator (Bit 7). When the Z-80 performs arithmetic operations on signed 7" 
numbers, binary two's complement notation is used to represent and process \ 
numeric Information. A positive number 1s Identified by a "zero" 1n bit 7. A 
negative number 1s Identified by a "one". The binary equivalent of the 
magnitude of a positive number 1s stored in bits to 6 for a total range of 
from to 127, A negative number is represented by the two's complement of 
the equivalent positive number. The total range for negative numbers is from 
-1 to -128. 

When Inputing a byte from an I/O device to a register, "IN r,(C)", the 
"S" flag will indicate either positive (S*0) or negative (S»l) data. 



\ 



-.1* 
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Assembly Language Pseudo-OP Codes 



There are many pseudo-OPs which EDAS will recognize. These assembler 
operations, although written much like processor instructions, interface to 
the assembler Instead of the Z-80 processor. They direct the assembler to 
perform specific tasks during the assembly process but have no meaning to the 
Z-80 processor. Some of these pseudo-OPs generate data values used by your 
program and are called "data declaration" pseudo-OPs. Others control paging 
operations and may be best termed, "listing" pseudo-OPs. A broad range of 
operations to Invoke the assembly of blocks of code based on conditional 
evaluations are supported through many "conditional" pseudo-OPs. These 
assembler pseudo-OPs are: i 



V, 



OB 

DC 
OS 

OW 



Constant Declarations 

specifies a data byte or string of bytes. Also 
equivalent to DEFB, DEFM, and DM. 

specifies a multiple of byte constants. 

reserves a region of storage for program use. 
Equivalent to DEFS. 

specifies a word (16-bit data value) or a 
sequence of words. Also equivalent to DEFW. 



OEFL 
END 

EQU 
LORS 

0R6 



Origins and Values 

establishes a value for a label which can 
be altered during the assembly. 

signifies the end of a *6ET or *SEARCH member. 
Will Indicate the end of the assembly when 
detected 1n the text buffer. Supplies the 
execution transfer address. 

estallshes a constant value for a label. 

establishes a load origin for executable 
object code files. 

establishes an execution origin for executable 
object code files or in-memory assemblies. 



3 
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Conditionals 
conditional evaluation of expression, 
logically TRUE if expression! » expression?, 
logically TRUE if expressionl < expression2. 
logically TRUE if expressionl > express1on2. 
logically TRUE if expressionl <> expression2. 



IF 

IFEQ{$) 

IFLT{$> 

IF6T{$> 

IFHE{$} 

IFDEF 

IFNDEF 

IFREF 

asE 

EMOIF 
Note: "{$>" 



logically TRUE 1f "label" has been defined 
prior to this statement, else FALSE. 

logically TRUE 1f "label" has not been defined 
prior to the statement, else FALSE. 

logically TRUE if "label" has been referenced 
but not defined prior to the statement, else 
FALSE. 

alternate clause to be assembled 1f the prior 
clause has evaluated TRUE. 

signifies the end of a conditional block. . 

denotes alternate macro string comparison. 



>saas«saisssai!iSBMaiis8i»(saaaBBBMaaaitasasa»isaBaia>saraiaai 

Miscellaneous 

COM generates an object code file comment record. 

EMDM designates the end of a MACRO model. 

ERR forces an assembly error. 

MACRO desigantes the prototype of a MACRO model. 

PASE transmits a form feed during a listing. 

SPACE generates extra line feeds during a listing. 

SUBTTL Invokes a heading sub-title for listings. 

TITLE invokes a heading title for listings. 



Ay 
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PSEUDO-OP OB 



The "DB" pseudo-OP is used to define a data byte Or series of bytes. Its 
syntax is: 



DB ni.nM.'c'H.sH, expression} 
n 



• c « 



• el 



defines the contents of a byte at the current 
reference counter to be "n". 

defines the content of one byte of memory to 
be the ASCII representation of character "c". 

defines the contents of n bytes of memory to 
be the ASCII representation of string "s", 
where "n" is the length of "s" and must be in 
the range 1-63. 



expression is a mathematical expression which evaluates 
to a number in the range <0-255>. 



ft 



The constant declaration "DB" permits the concatenation of its data 
arguments using the comma "," as an argument separator. Data values are 
denoted according to the specifications in the chapter on ASSEMBLY LANGUAGE 
INFORMATION. 

In order to provide compatibility with constant declarations of other 
assemblers, EDAS provides other data declarations that are completely 
equivalent to "DB". The following pseudo-OPs can be used in lieu of "DB": DM, 
DEFB, DEFM. Because DB, DEFB, DM, and DEFM are exact equivalents and all four 
are supplied only for ease of transition from other assemblers, each must be 
contained in the OP-code table used by EDAS. However, only "DB" was selected 
to be high up 1n the OP-code table. Since the OP-code table is searched 
sequentially, the use of "DB" 1n your source code will produce a slightly 
faster assembly than use of DEFB, DEFM, or DM. 

"DB" string arguments permit two connected single-quotes to Indicate a 
single-quote value PROVIDED that two or more characters precede the 2-quote 
appearance 1n the string. For example: 

DB 'AB'^' 

will produce the character string: 41 42 27 43. This may have been coded as a 
complex declaration such as, "'AB'^H.'C'", but the extensive declaration 
support in EDAS provides the easier specification. 
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The following partial assembler listing demonstrates the versatility of 
the expanded constant declarations. * 



54 00070 DB 'This',' '.'Is',' '/a',' '/test' 

68 69 73 20 69 73 20 61 
. 20 74 65 73 74 
000E 01 00080 DB 1,2,'buckle your shoe' ,3,4, 'close the door' 

02 62 75 63 6B 6C 65 20 

79 6F 75 72 20 73 68 6F 

65 03 04 63 6C 6F 73 65 

20 74 68 65 20 64 6F 6F 

72 
0030 54 00090 DB 'This is a tes', 't'!80H _ 

68 69 73 20 69 73 20 61 n 

20 74 65 73 F4 

In the last example, note the expression argument specified as, 

! t'180H 
Much more complicated expressions could be utilized. 

The expansions of the constant (the rows of eight bytes per row) will 
appear In listings. The expansions may be suppressed from your listings by 
using the , assembler switch, -NE. 
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PSEUDO-OP OC 



This pseudo-OP defines a repetitive constant. Its syntax is: 



OC quantity, value 



quantity 



value 



specifies how many times that "value" is to be 
repeated as a data byte. It can be defined as 
any other data definition: n, expression, ' c'. 



aj 



is the constant to be repeated. As 1n a "DB" 
data declaration, the value can be specified 
as a character, 'c', a numeric value, n, or an j 
expression evaluated to a number 1n the | 

range <0-255>. j 



The pseudo-OP, "DC", will define a repetitive constant and eliminate the 
necessity of defining a series of identical data values by long DB 
specifications. For example, the following two statements are equivalent: 

DB 0,0,0,0,0,0,0,19,0,0,0,0,19,19,19,19 

OC 16,0 

The latter is much shorter, easier to enter as text, more readable, and takes 
up less space in its source form. 



The "quantity" must range from 1 to 65535 (a zero value will result in 
65536). The "value" must be less than 256. With this pseudo-OP, you can 
generate repetitions of a single constant. For example, say you want to set 
100 storage locations to a zero value during the assembly. Insert the 
statement, 

DC 100,0 

and it will be done. A character constant can also be used for "value" as 
Illustrated in the following example: 

DC 256,' A' 

which will set the next 256 storage locations to the letter, "A". 

The expansions of the constant will appear in listings just as they do 
in the DB expansion. The expansions may be suppressed from your listings by 
using the assembler switch, -NE. 
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PSEUDO-OP OS 



This pseudo-OP is used to reserve a quantity of storage locations for 
use by your program. Its syntax is: 

I I 

I OS nn 

I 

I nn reserves "nn" bytes of memory starting at the 

I current value of the reference counter. 

I 

u»mammwmmasmwumMmmsKaiBmmm&ummmwmmmmammmmasmmmmwmmm&mamua*aammmmmam 



jfT, 



The OS pseudo-OP can also be entered as "DEFS" in order to provide a 
compatibility with other assemblers that use only "DEFS" to reserve storage 
locations. For reasons of efficiency as discussed earlier, use of the M DS M in 
lieu of the "DEFS" will result in slightly faster assemblies. Therefore, it 
is suggested that if you are transfering over to EDAS from another assembler, 
globally change all "DEFS" pseudo-QPs to "OS". 

The quantity, "nn", can be a data value or an expression. Note that "OS" 
does not define data values. The "DS" pseudo-OP adds the quantity of storage 
locations reserved to the current program counter (PC) to calculate a new PC 
value. When generating an object code file, this action will cause the next 
assembled byte to create a new load record. The following examples depict 
various "OS" declarations. 

Examples of the OS pseudo-OP 

FCB OS 32 

will define a 32-byte region for later use as a File Control Block. 
Its origin can then be referenced as "FCB* 1 . 

TABLE DS TABLEJ.ENGTH * TABLEJ.IDTH 

will reserve a quantity of storage locations equal to the result of 
multiplying the two terms, TABLEJ.ENGTH and TABLEJUDTH. 

If your source code is being assembled with the "-CI" switch, EDAS 
automatically converts all "DS" declarations into equivalent "DC" 
declarations using a value equal to zero. The above two examples would 
therefore be translated to the following: 

FCB DC 32,0 

TABLE DC TABLE LENGTH * TABLE WIDTH,0 



PSEUDO-OPS - DATA DECLARATIONS 
4-6 



~/ 



S 



■^Jy 



,^^m 



iii ^tea» a ^^ l ^^^^^ tf ^^^t^^ 



HmmnmmfcMmm 



mmmm 
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PSEUDO-OP DU 



This declaration specifies a 16-bit data value. Its syntax is: 



DW nn{ 8 'cc , }{,nn> 
nn 



• CC ' 



defines the contents of a 2-byte word to be 
the value, "nn". 

defines the contents of a 2-byte word to be 
the characters, 'cc* 



*9 



^.(Jpkn.. 



The DW pseudo-OP can also be entered as "DEFW" in order to provide a 
compatibility with other assemblers that use only "DEFW" to declare data 
words. For reasons of efficiency as discussed earlier, use of the "DW" in 
lieu of the "DEFW" will result 1n slightly faster assemblies. Therefore, 1t 
1s suggested that 1f you are transfering over to EDAS from another assembler, 
globally change all "DEFW" pseudo-OPs to "DW". 

In the expansion of the data word, Its least significant byte 1s located 
at the current program reference counter while the most significant byte 1s 
located at the reference counter plus one. The data word can be a numeric 
constant, an expression that evaluates to a 16-bit value, or a character 
constant of one or two characters. The following examples illustrate various 
forms of "DW" data declarations. 

0000 1027 00100 DW 10000,1000,100,10,1 
E803 6400 0A00 0100 



6261 00110 DW 'ab' 

000C 5200 00120 DW 'R'.'o'.'y' 
6F00 7900 

Note that 1f a single character 1s defined as a character constant word, the 
low-order byte of the word will contain the character value and the 
high-order byte of the word will be set to zero. 
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PSEUDO»OP OEFL 

The "DEFL" pseudo-OP assigns a value to a label. The value 1s permitted 
to be changed during the assembly. The "DEFL" syntax 1s: 



label OEFL nn 

label DEFL expression 



nn 



sets the value of "labeT" to the quantity "nn" 



expression sets the value of "label" to the evaluated 
result of "expression"* 



/"? 



This declaration 1s similar to the "EQU" declaration except that the 
label value 1s permitted to change during the course of the assembly without 
producing phase errors (which are generally observed as numerous MULTIPLY 
DEFINED SYMBOL errors). If the value of "label" 1s declared by a "DEFL", the 
declaration can be repeated 1n the program with different values for the same 
label. One useful purpose to support this method of coding would be to 
slmllate the maintenance of two program reference counters." Observe the 
following sequence of code: 

?de 

; Save current program counter 
; Set PC to data counter 
a test mess age', CR 

; Save current data counter 
; Reset PC to program counter 

; Save current program counter 
; Now set PC to the data counter 
mess age', LF.CR 

; Save new current data counter 
; then re-establish PC 
of program code 

The program maintains two address counters. One 1s utilized as a counter to 
keep track of the code portion of the program (PROGS), while the other is 
used to keep track of the data portion of the program (DATAS). This technique 
can be used to keep the data fields associated with routines in close 
proximity to their associated routine in the source code, while the object 
code location of the data is collected Into some other region. 

Labels defined as "DEFL" will be carried as "DEFL" in the EQUate file 
generation of the Cross-Reference utility. They will also be notated in the 
cross-reference listing by a plus sign, "+", prefix to the label name. 





... some 


code 


FROGS 


DEFL 


$ 




ORG 


DATAS 


MSG1 


DB 


•This 1s 


DATA$ 


DEFL 


S 




ORG 


PROGS 




. . . more 


code 


PROGS 


DEFL 


S 




ORG 


DATAS 


MSG2 


DB 


'Another 


DATAS 


DEFL 


S 




ORG 


PROGS 




... continuation 
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PSEUDO-OP END 



The "END" pseudo is used to denote the exit of a *GET or *SEARCH 
process, or when used 1n the memory text buffer, it will denote the end of 
the source code. Its syntax 1s: 



END {nn> 
END {label) 



nn 



label 



signifies the end of the source program (see 
text for handling during *6ET and *SEARCH). 

specifies an execution transfer address branch 
that will be used by the system loader. 

specifies an execution transfer address branch 
to be the value of "label". 



f~i 



The "END' 
source code 



statement 1s used to Indicate to the assembler, when the last 
statement is reached so that any following statements are 



Ignored. If- no "END" statement is found, a warning 1s produced. The ENO 
statement can specify a transfer address (I.e. END LABEL or END 6000H). The 
transfer address 1s used by the DOS program execution to transfer control to 
the address specified 1n the END statement. Note that the END statement 
cannot have a label in therlabel: field, of the (Statement). 

The "END" statement is treated differently 1f detected while assembling 
a file that was the target of a U *GET filespec" or "*SEARCH library". In the 
case of the *GET, the "END" is treated as if the end-of-file was reached and 
EDAS will switch back to assemble from what ever invoked the *GET. A similar 
process takes place with the *SEARCH, except that EDAS continues the 
searching process in Its normal manner. 
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PSEUDO-OP EQU 



This pseudo-OP assigns a constant value to a label. Its syntax 1s: 



label EQU nn 

label EQU expression 



nn 



sets the value of label to nn. 



<*v 



expression sets the value of label to the calculated 
value of "expression" 

The "EQU" (equate) pseudo-OP 1s the generally accepted way to define 
constant values for use 1n your program. This declaration serves a different 
purpose than the the data declarations such as DB, DC, and DW. Data 
declarations specify storage locations that contain the values declared. The 
"EQU" assigns the value to the label; thus, anywhere the label 1s used, the 
assigned value is utilized. Your programs will be more readable, and easier 
to maintain if the values need to be altered 1n a program revision. For 
Instance, the first starting address of a video memory area might be X'3C00' 
or 15360. If your program had a routine to blank out this video area, 1t 
could be written as <A>: 



CLEAR 



LD 


HL, 15360 


LO 


DE, 15360+1 


LD 


(HL),' ■ 


LD 


BC.1023 


LOIR 




RET 





CLEAR 



<A> or <B> 



LD 


HL, SCREEN 


LD 


DE,SCREEN+1 


LD 


HL,' ' 


LD 


BC.CRTLEN-1 


LDIR 




RET 





If you had established labels for the video screen with: "SCREEN EQU 15360" 
and "CRTLEN EQU 1024", then the above routine could be re-written as in <B> 
which not only makes 1t more readable, but when you revise your program for 
one that has video memory at a different address, all you need do 1s change 
the value of one "EQU" statement. 

It is also useful to establish a series of equates for system vectors 
that are to be used In yeyr program. Don't code a statement as "CALL 4424H"; 
establish a label such as "90PEN EQU 4424H\ then your CALL statement is 
coded as "CALL ©OPEN", certainly much more readable. 

An "EQU" can occur only once for any label. A multiple "EQU" with 
different values will result in the MULTIPLY DEFINED SYMBOL error. 



J 
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The "LORS* pseudo-OP is used to establish an object code file (or part 
of one) that loads at an address different from where it will execute. The 
syntax of "LORG" is: 



LORG nn 

LORG expression 



nn 



is the address to start loading the object 
file (or part of the file). 



expression when evaluated, "expression" will be treated 
the same as "nn". 

naanxaasxauuausaaausaaasisaniszsinsaaiKiiunuiiHiu 

A load-origin assembler directive, "LORG", is provided to cause the load 
addresses of the object file to be based on the LORG operand while the 
execution code address references will still be based on the "ORG" operand. 
This Is useful to construct a module (or part of a module) that will load at 
an address different from Its execution address. For example: 

ORG 5200H 
- LORG 7000H 

will assemble code so that absolute address references and the execution 
addresses are referenced fromX'5200'; however, the object code file will 
start loading at X'7000'. Any subsequent "ORG" will maintain the offset 
difference established at the previous "ORG" until another "LORG" is 
detected. 

Why Incorporate such a facility Into the assembler? How can I make use 
of it 1n my programs? Easy answer! Consider this scenario. A program 1s 
composed of three large modules, A, B, and C. Module "A" performs 
Initialization, has "run-time" routines, and determines whether module "B" or 
"C" is to be executed. Consider further, that once either module "B" or "C" 
execute, the program terminates. If we assemble all three modules so that 
they are contiguous to each other, their execution take up more space than 1s 
actually needed. If we need to maximize the amount of memory available for 
data storage, buffers, and stack, we could use an "LORG" to have module "C" 
load after module "B", but "ORG" module "C" so that it executes where module 
"B" executes. When module "A" determines that it needs to execute module "C", 
1t can move the entire module in memory to "B's" position easily with an LOIR 
instruction. This will free up memory which can be used for the needed 
storage. 
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PSEUDO-OP ORG 



Wt S3 M X 3S SB M S * IB S& S3 SB 



The "ORG" pseudo-OP is used to establish an address for the program 
counter so that the absolute address references within a. program are 
designated. The syntax of "ORG" is: 



ORG nn 

ORG expression 



nn 



sets the address reference counter to the 
value "nn". 

expression when evaluated, "expression" will be treated 
the same as "nn". Terms of "expression" must 
be defined prior to the "ORG" statement. 



The "ORG" statement is used to tell the assembler at what address to 
begin generating the object code for statements which follow. The assembler 
will generate object code starting at the address specified "by "nn" or 
"expression", automatically advancing the program counter by the length of 
each instruction or data declaration assembled. The "DS" data declaration 
advances the program counter by the amount of storage locations reserved. 

A program can have more than one "ORG" statement. If multiple "ORGs" are 
used, and one or more inadvertantly will cause the overwrite of a previously 
assembled module of code, no warning message of any kind will be issued. It 
is left up to the programmer, to protect against such events by use of 
conditional tests (using conditional pseudo-OPs) and the "ERR" pseudo-OP. 

The ORG pseudo-OP causes no code generation itself but just prepares the 
assembly process to start a new object deck record with, the generation of 
subsequent object code (note that 1f the evaluated address Is one greater 
than the current PC, a new object deck record will not be started). 



y 



•^f 
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CONDITIONAL PSEUDO-OPS 

The "conditional" pseudb-OPs provide a powerful way to maintain a 
program that is slightly different when assembled to execute on different 
machine configurations. Instead of having to maintain multiple copies of a 
program, with each copy having some routines and modifications to make a 
"custom* 1 version of the program, by using the conditional pseudo-OPs, you can 
maintain one set of source code that has conditional segments (or blocks) of 
code that perform the "customization". It is very easy to specify which 
segments are to be assembled during a particular assembly. The structure of a 
conditional block is as follows: 

Ay 

aisMHiM»nuaiaan3»a3a3MSM»xs»»x»uaa»»uiuHsu 

IFxx argument of IF 
code block or segment 
ENDIF 

assassaaaaaaasxsasssaaaasasssaaaaaaasaaaaaaaaaaaaaaassssssaaua 

The argument of the "IF" takes on different formats depending on the 
particular "IF" pseudo-OP. It can be an expression, a label, or two 
expressions separated by commas. More on this later; for now, just refer to 
it as the argument. If the argument is evaluated to a non-zero value, it is 
interpreted as a logical TRUE condition. If the argument is evaluated to a 
zero value,* it is interpreted as a logical FALSE condition. When the 
condition is TRUE, the conditional segment between the "IF" and the "ENDIF" 
is assembled. If "expression" is evaluated to a zero value then the 
conditional block is not assembled but just listed (during the listing pass). 
For the sake of uniformity, use the value of "-1" for a logical TRUE and a 
"0" for a logical false so that, "FALSE EQU .NOT.TRUE" is a valid statment. 
These can be set as equates in the beginning of a program as follows: 



TRUE 


EQU 


-1 


FALSE 


EQU 


9 


MODI 


EQU 


TRUE 


M0D2 


EQU 


FALSE 


M0D3 


EQU 


FALSE 



BE CAUTIOUS WHERE THE OPERANDS OF THE CONDITIONAL ARE NOT DEFINED PRIOR 
TO THE -IF". THE CONDITIONAL BLOCK WILL MOST LIKELY EVALUATE "FALSE" ON PASS 
1 AND "TRUE" ON PASS 2 OR 3. 

Consider a program designed for execution on the Model's I, II, or III 

computer with different versions for each. The code blocks particular to a 

Model may be included in one set of source files but established as 
conditional blocks. For example: 
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IF MQD1JMQD3 

block of code for Model I or Model III 

ENDIF 

IF M0D2 

block of code for Model II 

END IF 

and all that 1s neccessary to Invoke a "custom" assembly is to set one of the 
conditional "switches" to TRUE and the others, FALSE. 

Conditional segments can also be nested, 1n case complicated logical 
constructs are needed or in case a conditional segment Itself has a 
conditional sub-segment. For example: ^ 

IF expresslonl 

IF expression2 
ENDIF 



J 



ENDIF 



1s a two*=level conditional.. Conditional segments can be nested to 
(16) levels although you will rarely find a need for more than three. 



sixteen 



The 
follows: 



conditional construct of IF-ELSE-ENDIF may be used. It 1s coded as 



IF expression 

code block 1. 

ELSE 

code block 2. 

ENDIF 



which irspHes that if "expression" 1s TRUE, code block I assembles. If 
"expression" in FALSE, then coda block 2 win be assembled. The ELSE 
construct 1s not required In. a conditional but may be used where you have two 
alternative segments that can be based on one switch. For instance, if your 
program has only two "switches", GO and NOGO, your constructs could be either 
of the following: 



IF SC 

code block 1 

ENDIF 

IF NOGO 

code block 2 

ENDIF 



if m 

code block 1 

ELSE 

code block 2 

ENDIF 
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^ 



As mentioned earlier, the IF argument can take one of three forms. The 
conditional structures of these are as follows: 

iiiia»iiaia«iaiisuia»aaiisssaa»i»H»a»H»i»»H»i»ii 



— Type I — 
IF exp 

code segment 

END IF 



— —Type II 

IFxx{$} expl,exp2 

• 

code segment 
ENDIF 



--Type III- 
IFyy label 

• 

code segment 
END IF 



"xx- 



{$} 



*yy* 



can be "LT», U EQ\ or "GT» representing less 
than, equal to, or greater than conditions 
respectively when comparing "expl" to "exp2". 

The M $" is specified in macro comparisons with 
the expressions treated as strings (see the 
chapter on MACRO PROCESSING). 

can be "DEF", "NDEF", or "REF" representing 
whether "label" has been defined, undefined, 
or referenced but undefined. 



aaaasaaaaaaaasaaxaaaaiaiaaaaaaaxaiiaiaaaaaxxiiaixaaaa 



n 



Type II - IFxx 



The Type I constructs have already been explained in detail. Among the 
Type II constructs, using "IFLT", if the value of expression 1 is less than 
the value of expression 2, then the conditional code segment will be 
assembled. Using "IFEQ", the conditional code segment will be assembled only 
if expression 1 and expression 2 have equal values. The "IFGT" pseudo-OP will 
assemble the conditional code segment (i.e. result in a TRUE condition) only 
if expression 1 has a value exceeding that of expression 2. The last 
possibility 1s "IFNE", which will cause the assembly of the conditional 
segment if the expressions are not of equal value. 

If, for instance, you want to ensure that a program does not assemble 
code past a particular address (maybe it would clobber another routine), then 
the ERR pseudo-op could be used 1n conjunction with IFGT to force an assembly 
error as follows: 

IFGT $,MAXADDRESS 

ERR Program 1s too long! 

ENDIF 

which compares the current value of the program counter (PC) to some 
previously specified maximum address. Once the PC exceeds this maximum value, 
the condition evaluates TRUE resulting in an assembly of the segment. The 
"ERR" pseudo-OP is used to force an assembly error. 
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Type III - IFyy 

Among the Type III constructs, "IFDEF LABEL" will evaluate TRUE if 
"LABEL" has been defined prior to the evaluation of the IFDEF on each 
assembler pass. "IFNDEF LABEL" will evaluate TRUE if "LABEL" has NOT been 
defined prior to the evaluation of the IFNDEF on each assembler pass. "IFREF 
LABEL" will evaluate TRUE if "LABEL" has been referenced but NOT defined 
prior to the evaluation of the IFREF on each assembler pass. 

The Type III constructs will find greater use when working with 
libraries of code. For instance, if a code segment is a specific routine and 
is surrounded with an IFREF-ENDIF conditional, the routine will only be 

assembled if' prior to the segment, the -"label" has bean referenced but noi; ? 
yet defined. If "label" is the entry point symbol to the routine., then the 
routine will be assembled if it is needed. In a similar manner, you may have 
a library routine that is always to be placed in your program unless its 
"label" has already been defined in some alternate routine. Surrounding it 
with the IFDEF-ENDIF conditional will inhibit its assembly if your program 
has defined that label. 

Suppressing FALSE Conditionals 

If during the listing pass, you want to suppress the listing of certain 
conditional segments that are not assembled (I.e. they are evaluated as 
FALSE), use the following sequence of operators: 

*LIST OFF 

IF expression 

*LIST ON 

code segment 

*LIST OFF 

END IF 

*LIST ON 

With this sequence, the "IF" and "ENDIF" lines will always be suppressed. The 
conditional block will onlybet listed 1f the' condi ti on being evaluated 1s 
logically TRUE. If all FALSE conditional segments are not" to be listed; thfen 
you may use the assembler "-NC" switch which inhibits the listing of all 
FALSE conditionals - including the IF-ENDIF statements. 

ENDIF 

\lery little has been said about the "ENDIF" statement. Very little need 
be said. Each "IF" statement must be matched up with a corresponding "ENDIF". 
The "ENDIF" is needed to define the scope of the conditional code block. 
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PSEUDO-OP COM 

I8S3ISXXSXS3SS 



This pseudo-OP is used to generate a comment record in the object code 
file. Its syntax is: 

■■■■saaaa»ssaassaBiMassassa»asi»aissii»s»saas»a>*iasisBS 
I 

I COM <string> 

| <string> is the information to be placed as a comment. 

I 

■ 

An object deck comment block can be generated within the executable 
object code file directly by using the "COM" pseudo-OP. The comment string 
must have a length less than 128 characters. As can be noted, the comment 
string must be enclosed in angle brackets. The closing bracket may be 
omitted. If lower case characters are desired, then single quotes must 
surround the angle brackets. Neither the quotes nor the angle brackets will 
be a part of the comment record. 

The "COM" pseudo-OP will generate a comment block in the object file of 
the format X'lF' followed by the string length, followed by the string 
itself. A typical use would be to place a non-loading copyright statement in 
an executable object code file. For example: 

COM. '<Copyr1ght (c) 1982 by Roy Soltoff>' 

will produce the comment record which would be viewed if the file were 
listed. 

The generation of the "COM" object code record will be inhibited if the 
assembly is performed using the "-CI" switch. A binary core-image file can 
not have a non-loadable record. 

PSEUDO-OP ERR 

isaaxsassaaaa 

The "ERR" pseudo-OP is used to force an assembly error. Its syntax is: 

I | 

I ERR {message} 

j I 

I message is an optional message to inform what is wrong. I 
I ' 

«..*•.•.— . — — — —— — —. — ^ 9SS3SSSS2SSSSSS333S3SSSS5333 

3«3f »3|3B3t3S3SS*a»353S3l3Sa3S3S3S3B3f3IXX* 

This pseudo-OP forces an immediate warning error and displays the 
optional message. It is commonly used in a conditional block for error 
trapping. 
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PSEUDO-OP MACRO 

» 86383*88 3^ 85 88 8? SB 35 3* 353! 

The MACRO pseudo-OP 1s used to define the prototype of a MACRO model 
Its syntax 1s: 

8SS3Cffi33ffiS38S8SSI83SS3SS3SS3331&8SSSasS3SaSVSS8SSt3S38StS33 



mname MACRO {#parmlH at dfltl}{,#parm2{=dflt2}H,...} 
1s the MACRO name used to refer to the MACRO 



#panm 



dfltn 



are dummy parameters of the MACRO which will be 
replaced by actual parameters during the MACRO 
Invocation. 

are optional defaults to be used for the dummy 
parameters when a parameter 1s not provided in 
the MACRO Invocation. 



A-j 



s«8axiaa»asisassxstis»333aszsisss»sss»:s»s»8M*i33333saiMS 

MACROS are an extremely powerful tool in an assembler. It provides great 
convenience in writing programs in building block form. For this reason, an 
entire chapter has been devoted to MACROS. You should refer to "the chapter 
entitled, MACRO PROCESSING, for information concerning the use of MACROS. 
Suffice it to say here that MACRO invocations can be nested to eight levels, 
parameters may be passed by position or by keyword, and a special operator 1s 
available to test the length of parameter substitutions. 

pseudo-op tmn 



This pseudo-OP 1s used to specify the scope of a MACRO model. It is used 
much like the "ENDIF". Its syntax is: 

&&& 38 SB 33 313931 8539 SS SS 3S8S SB SKSt SSSS 3$ S3 3fi SSStSSStSS 3E B«SS»3£SSBSaaSSKSS3SS»3SSeSS*SS3SXSS3Sffi3S»»»3 



mname MACRO parms 

model statements 
ENDM 



> 
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LISTIN6 PSEUDO-OPS 



Four pseudo-OPs are available to control the assembler listings. These 
are: .PAGE, SPACE, SUBTTL, and TITLE. Their syntax is: 



PAGE {OFF} 

SPACE n 

SUBTTL «str1ng>> 

TITLE <string> 

OFF is an optional parameter for PAGE to suppress 

the listing of the PAGE statement. 

n specifies how many line feeds to generate. 

<str1ng> is the title or sub-title string to appear 1n 
the listing headings. 



A new page can be forced to provide separation of routines, modules, 
etc. by using the "PAGE" pseudo-op. This pseudo-OP will be ignored if 1t 
appears between *LIST OFF and *LIST ON. "PAGE" accepts an operand of "OFF" to 
suppress the listing of the line containing the PAGE pseudo-OP (i.e. "PAGE 
OFF" will issue the form feed but suppress printing of the line containing 
the "PAGE" pseudo-OP). 

"SPACE n" performs line spacing whenever the "SPACE" pseudo-OP is used. 
When assembled, "n" is the number of lines to space and 1s interpreted as 
modulo 256. The line containing the SPACE pseudo-op is not displayed. This 
pseudo-op also will be Ignored if it appears between *LIST OFF and *LIST ON. 

A sub- title to a heading 1s permitted with the M SUBTTL" pseudo-OP. The 
subtitle string length can be from zero (0) to 80 characters in length. A 
zero length indicates that sub-titling is disengaged. 

Lower case strings can be maintained by the use of single quotes, 
surrounding the angle brackets. You may change the subtitle by using 
additional "SUBTTL" pseudo-OPs throughout the text. Subtitles will appear on 
the first page following the "SUBTTL" pseudo-op. A "PAGE" pseudo-OP following 
a "SUBTTL" will force the subtitle to appear immediately. If the "SUBTTL" 
text string is null (of zero length), then subtitling will cease on the 
subsequent page. A line will also be skipped between the subtitle and first 
printed text line on the page. Where many *GETs are being used, you may want 
to establish a sub-title for each to provide a visual indication on the 
listing. For example: 
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SUBTTL '<Module B - initialization routines>' 

PAGE OFF 
*GET MODULES:! 

SUBTTL *<Module C - data extraction routines>' 

PAGE OFF 
*GET MQDULEC:! 

will print the sub-title on each page of the listing associated with MODULEB. 
Ideally, each module should he preceded with a SUBTTL statement. 

The "TITLE" pseudo-OP automatically invokes a page heading and adds the 
title to the headings of assembler listings. The title string is limited to 
28 characters and only one "TITLE" is accepted. The left and right carets* 
(angle brackets) must be entered but are not output in the listing - they 
serve only to delimit your title string. The title line will include the EDAS 
version, the date and time retrieved from the system, your title string, and 
a page number [page number is limited to the range <l-255> and will wrap 
around to zero if more than 255 pages are printed]. For this reason, if you 
use a title, it is advisable to set 0A r E «ind TIME prior to executing the 
Editor Assembler. A line will be skipped .setween the title and start of 
printed text (or subtitle if used). Lower case titles will be maintained by 
surrounding the angle brackets with single quotes as in: 

TITLE '<This is an UC/lc t1tle>' 

The first "TITLE" pseudo-OP found in the text will be used for titling. 
Any other "TITLE" pseudo-ops will be ignored. 
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ASSEMBLES DIRECTIVES 

SMiMiaataussiiui 

The MISOSYS Editor Assembler, EDAS Version IV, supports five assembler 
commands. In contrast to source statements which are translated to machine 
language, these directives are "conversation" to the assembler. Each directs 
the assembler to behave in a particular manner or perform a specific 
function. The directives, by themselves, do not generate any machine language 
code - they merely act as "commands" to the assembler. Each "command" must 
start In column one of a source statement line, and must start with an 
asterisk (*). Only the first character of each directive Is significant. The 
entire directive "word" may be entered, or the directive may be abbreviated 
to Its first character. The assembler directives are: 



SBaaaaauaasaausaBSBBBaaaaaauaaaBaaauuaaauuuaauaam 



v_ 



♦GET file , Causes the assembler to begin reading source 
code from the "file". 

*LIST OFF Causes the assembler listing to be suspended, 
starting with the next line. 

♦LIST ON Causes assembler listing to resume, starting 
with this line. 

♦MOD exp Advances the "module" character substitution 
string and optionally sets/resets the prefix. 

♦PREFIX exp Establishes or disengages a prefix character 
for the MACRO substitution string. 

♦SEARCH lib Invokes an automatic search of the Partitioned 
Data Set (PDS) "lib" to resolve any undefined 
references capable of being resolved by PDS 
assembler source member modules. 



■aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



aaaaaaaaaaaaaaa 
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*6ET fUesptc 

This directive Invokes assembly from a source disk file. Its syntax 1s: 



N 



The text buffer can be composed of nothing but *GET statements (and one 
END statement) which will provide maximum space 1n the text buffer for 
generation of the symbol table. For example, the following could represent 
the source linkage needed to assemble a program called "PARMDIR/CMD": 

; PARMOIR/ASM - 04/07/82 

; Linkage to assemble PARMDIR 

*GET PARMDIR1 
*GET PARMDIR2 
*GET PARMDIR3 

ENO PARMDIR 



) 



*GET fllespec 

fUespec Causes the assembler to begin reading source 
code from the file, "fllespec*. 

miammmwimmmmmiBmmatastmsimwtMammatamiBimisiSi^Mmwsiasssimmmismawmamicmmwmwiamaitsmmm 

AT? 

This directive tells the assembler to temporarily switch Its source 
assembly to the file Identified as "fllespec", and use It to continue the 
assembly. A default file extension of "ASM" will be used 1f none 1s provided 
in the directive statement. The file itself can be headered and/or numbered, 
as EDAS will automatically detect its type and adjust accordingly. When the 
end-of-fHe 1s reached, or an assembly language "END" statement 1s read, 
assembly automatically resumes from the next statement following the 
statement which invoked the "*GET". Any "END" statement read during the *GET 
process will be Ignored as the program end. The only "END" accepted will be 
that in the text buffer. 

"*GETs" can be nested to five (5) levels. That 1s, a statement 1n memory -^ 
can GET a file which GETs a file which GETs a file which GETs a file which 
GETs a file. This assembler directive is extremely powerful. It can be used > 
to provide the capability of assembling large programs which are stored on 
disk 1n modules, since more than one *6ET may be 1n the text buffer or 
gotten" file. 



.). 
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LIST OH/OFF 



This directive 1s used to suppress the listing of blocks of code. Its 
syntax 1s: 

aaBsiasasssisasaiiaiiiBxsssassaausaaaaaasiissBSixsasaiiasiussis 



*LIST off/on 
OFF 

ON 



Causes the assembler listing to be suspended, 
starting with the next statement. 

Causes assembler listing to resume, starting 
with this statement. 



The pair of directives, M *LIST OFF" and "LIST ON", can be used to 
suppress the listing of a block of code. Once the "*LIST OFF" 1s Invoked, all 
statements following will not be listed to the display or the line printer 
(1f assembler switch -LP Is specified). The directive "*LIST ON" 
re-establishes standard listing. An exception to the suppression 1s that any 
assembler source statement containing an assembly error will be listed along 



you can use an 



"*LISf 



with Its appropriate error message. In this manner, 
\ OFF" directive at the beginning of your assembly source (to suppress all 
listing) and lines containing errors will be forced to be displayed by EDAS. 

Examples of the *LIST directive: 

*LIST OFF 

DB 'This line will not be displayed!' 
*LIST ON 

*LIST OFF 

DB 'Only the next line will be displayed!' 
LD (M.100 
♦LIST ON 
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*W0D expression 



This directive 1s used to increment a character substitution string for 
the purpose of simulating local labels. Its syntax is: 



*M0D {expression} 

Advances the "module" character substitution 
string. 

expression 1s an optional expression to specify a prefix , , 
character to the substitution string or reset ' 
the current prefix. 



The "*MQ0" directive will Increment a string replacement variable each 
time the directive 1s executed. The string will replace the question mark, 
M ? H t eft 1ft labels and label pg-pgpgnggg uod in any ling assembled 
from a *GET or *SEARCH file. Its use 1s essentially applicable to subroutine 
libraries where duplication of labels could occur. By specifying the "*M0D" 
directive as the first statement of each module of code and by using a 
question mark in labels, you can construct source subroutine libraries for' 
use In your programs without having to worry about duplicate labels occur 1ng. 
Unless at least one "*M0D" statement Is specified, the question mark will not 
be translated. 

Labels such as $?001 will have the ■?■ replaced with the current "MOD" 
string value. Thus, a "*M0D" directive preceding each module will force $?001 
labels 1n each module to be distinctly named by having the question mark 
replaced with the substitution string. The "MOD" string value cycles from 
A-Z, then from AA-AZ, BA-BZ, .... ZA-ZZ. This will allow for a simulation of 
"local" labels. Remember, the "?" substitutions will only be made to those 
source lines fetched from a *GET or *SEARCH file, not from statements 
resident in memory! It really was designed that way folk's, It's not just a 
limitation. 



If you need more than the 702 unique string values generated by a 
single/dual alphabetic string (26*26+26), you will have to specify a 
prefix". The prefix invokes a user-sped fled third character for 

The "*M0D" directive provides for the assignment of the 
the substitution string. You control the prefix. For 



substitution string, 
character prefix to 
example: 



"MOD 
the 



*M0D •$' 

assigns the character "$» to prefix all "MOD" substitutions. Once Invoked, 

you can change to any other character by another "*M0D" command or remove the 

prefix by entering an expression whose value is zero. 



> 
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*PREFIX expression 



This directive gives you the capability of specifying a constant third 
character to the MACRO substitution string. Its syntax is: 

naiu»Hxuiu»3*ii»M»saaznsiaa»«taiaa»»i»iH»»ita 

♦PREFIX expression 

expression establishes or disengages a prefix character 
for the MACRO substitution string. 



The Macro substitution string can be prefixed with a user-entered 
character constant. This 1s achieved by using the "♦PREFIX" assembler 
directive. The expression character or value entered in field two becomes the 
prefix character. It must be a character that 1s valid for assembler source 
labels. For example, 

♦PREFIX '$' 

will cause MACRO local label string substitution to be expanded as "$AA", 
"SAB", "SAC", ... A binary zero value will eliminate any prefix character 
once Invoked, For example, 

♦PREFIX 

will disengage the MACRO string substitution prefix character. 

For more Information on the use of the MACRO prefix character, see the 
chapter on the MACRO PROCESSOR. 
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*SEARCH fUespec 



This directive 1s used to Invoke an automatic search of a Partitioned 
Data Set (PDS) source library. Its syntax 1s: 

*SEARCH fllespec 

fllespec Invokes an automatic search of the PDS 
"filespec/LIB" to resolve any undefined 
references capable of being resolved by 
PDS assembler source member modules. . 



This assembler "*SEARCH fllespec" directive 1s a very powerful feature. 
It will Invoke, a directory search of the Partitioned Data Set "fllename/LIB" 
for all members that will resolve undefined references In the source 
assembly. This provides a source library structure for EDAS. "*SEARCH" will 

require two (2) Igygls of • # *Q£'f | * nesting. Also, restrictions prevent a 
M *SEARCH" member from using a "*GET U directive or another "*SEARCH" directive 
(such a request would be ridiculous anyway). The library members must be 
lowest level. The default file extension for searched files 1s ".LIB". 

The PDS source library constitutes members composed of one or more 
routines. Each routine that needs to be automatically fetched should have Its 
routine name (the label field entry) in the PDS member directory. This 1s 
accomplished by naming the source file to be appended to the library the same 
name as the routine or by appending using a MAP. Details on constructing and 
using Partitioned Data Sets 1s included with PDS documentation. The PDS 
utility is available separately. 

EDAS will search the PDS library and locate a member name that matches 
up with a symbol table entry. If that symbol 1s currently undefined, the 
souree nember will be accessed and read just as 1f 1t were the target of a 
"GET". EDAS will verify that the member just accessed did 1n fact define the 
symbol Invoking Its access. If a member 1s accessed and there exists no 
symbolic label in the member that has the same name as the member name, EDAS 
will abort the assembly and advise of a library error by displaying the 
message: 

Meisber definition error? fllespecCmember) 

At the conclusion of the member's source code, EDAS will continue to 
search the PDS library until 1t exhausts all PDS members. There are no 
restrictions on the order of members. Routines in one member can reference 
other members with complete disregard as to any ordering of entries In the 
PDS. EDAS will correctly access all members required. 



\s 
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Where more than one routine 1s 1n a member, each should be surrounded 
by IFREF's/ENDIF and each should have an entry in the member directory (you 
must use the MAP option of PDS to provide multiple entries to a member). This 
will benefit by not having needless routines appear in your object code 
output. For example, the following depicts two routines stored as one member 
in a PDS. 

; Entry for routine entitled "MOVE" 

IFREF MOVE 
MOVE . ;Routine of code 

END IF 
; Entry for routine entitled "SHIFT" '* 

IFREF SHIFT 
SHIFT . ; Routine of code 

« 

END IF 

If your source code references "SHIFT" but not "MOVE", as long as both 
"SHIFT" and "MOVE" are member entries In the library PDS directory, a 
"♦SEARCH" of the library will access the member and assemble only the "SHIFT" 
routine. You should read the section on the "IFREF" conditional in the 
chapter on ASSEMBLER PSEUDO-OPS to understand the evaluation of the "IFREF". 
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Macro Processing 
WHAT IS A MACRO? 



In virtually all programs* you will find particular sequences of code 
that are repeated. These sequences might be termed short routines.. They could 
be so short that the overhead needed to set them up as CALLable routines is 
ineffective. Or, they could be longer routines that just cannot be 
constructed as CALLable segments. You may even want a code sequence to be an 
in-line assembly in contrast to a CALLable routine for the purpose of fast 
execution. By far the most needed function, is to be able to have 
parameterized routines - algorithms that operate on different values each 
time the algorithm is invoked. 

There are at least three ways to deal with routines that are repeated in 
a program. You can <I>nsert the f> entire routine wherever it is needed. You 
could also <C>opy 1t from the first appearance to wherever you needed the 
routine. Or you could establish the routine as a macro. The first method is 
obviously tedious on your fingers. The second, is not tiring, but could take 
up more source storage than is desirable. Also, if you decide to change the 
routine's algorithm, having many copies in a program can be cumbersome to 
update. 

The third method mentioned is the use of macros. Consider the following 
commonplace sequence of code: 

LD HL, VALUE 
LD (MEMORY ),HL 

How many times is this little sequence repeated in your programs? Five? Ten? 
If we set up a macro near the beginning of our program that looked something 
like this: 

STOR MACRO #VAL,#MEM ;Macro to store "VAL" into memory 

LD HL,#VAL ;Get value into HL 

LD (#MEM),HL ;Load value into memory 

ENDM ;End of the macro 

then we could perform the above two statements with one macro call as 
follows: 

STOR VALUE, MEMORY ; Invoke the macro 

The first pant of the example, defines a macro called "STOR". This is done 
exactly once per program! If we save our macros in a macro source file, each 
of our programs could "*GET MACROS"; thus, we would not have to even manually 
enter the macro into each program. 

We invoke the statements defined in the macro by specifying the macro 
name AS IF IT WERE AN OPCODE. Using the macro invocation method, we can save 
storage space and introduce structured techniques to our coding. Notice that 
we have used some fictitious names when the STOR macro was defined. These 
names are called "dummy" parameters. They serve to provide a means to pass 
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actual parameters when the macro 1s Invoked. It 1s through the dummy 
parameters that the real power of the macro Is utilized. During the macro 
Invocation, the model statements are expanded with substitutions for the 
dummy parameters that are provided In the macro call. 



"^ 



MACRO DcFIifXTIOti 



The format 
example: 



for a macro definition 1s Illustrated 1n the following 



MOVE 



MACRO 


#parml , #parm2*df 1 t2, #parm3 


LD 


HL,#parml 


LO 


DE,#parm2 


LD 


BC,#parm3 


LDIR 




ENDM 





//*~i 



The macro definition consists of three parts: a macro prototype, a macro 
model, and the ENDM statement. The prototype 1s used to specify the macro 
name and the dummy parameter names used 1n the model. Default substitutions 
may be specified 1n the prototype to be used 1f the corresponding parameter 
1s not passed 1n the macro Invocation. The macro model contains all of the 
assembler statements to be generated when the macro is Invoked. The model 1s 
sometimes called the macro skeleton or template. The dummy parameter names 
occupy the positions where the actual parameters will be placed by the macro 
processor 1n EDAS. The third part, the ENDM statement, 1s used to Indicate 
the end of the macro model. 

When a macro 1s defined, 1t 1s not assembled Into your program. The 
macro prototype 1s parsed and analyzed. The macro definition 1s then stored 
1n a compressed format within the macro storage area. Comments appearing with 
the macro definition are not stored. That means that 1f the macro expansions 
are listed 1n the assembler listings, they will not include the comments - 
only the definition will. 



•\ 



USIMS MACROS 
6-2 



L 



Macro Prototype 



Macro Processing 



The MACRO pseudo-OP 1s used to define the protot,ype of a macro model. 
Its syntax 1s: 

imame MACRO {#parml}{»dfltlM,#parm2{-dflt2} }{,...} 
mane 1s the macro name used to Invoke the macro. 



fpsrm are dummy parameters of the macro which will 

be replaced by actual parameters during the 
macro Invocation. "#" is a required prefix. 

dfltn are optional default strings to be used for 

the dummy parameters when a parameter is not 
provided in the macro invocation. 



*? 



\ 



Macros are named just like symbolic labels. The same rules apply. The 
length of macro names can range from <1-15>. Special characters <@, $, _> may 
be used 1n the name construct. Oo not use the question mark in macro names as 
It would conflict with the symbol substitution string use made of "?". 



There 1s no upper limit on the number of macro parameters; however, you 
can not exceed the length of a standard assembler source statement. 
Therefore, the statement length becomes the limiting factor. As 1s the case 
with macro names, the rules for naming dummy parameters are identical to the 
rules for labels. The "dummy" names are not included in the symbol table 
generated by EDAS, thus there 1s no restriction on reusing the same name as a 
"dummy" for a label; however, to avoid confusion, it 1s recommended that you 
avoid using dummy names as symbolic label names. 



Default strings can contain any character except the comma, ",". The 
comma 1s used as a field delimiter. There 1s no limit to the length of a 
default string other than the limiting factor of the statement length. 



Macros must be defined prior to use but can be 
"*6ET files* or memory text. 

Macro Model 



defined in either disk 



Any valid Z-80 statement, EDAS pseudo-OP, or assembler directive (except 
"*GET" or "*SEARCH") is valid in the macro model - except the "MACRO" 
pseudo-OP (no nested definitions, please). 
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ENDM pseudo-OP 

This pseudo-OP 1s used to specify the scope of a macro model. It 1s used 
much like the "ENDIF". Its syntax 1s: 

mname MACRO parms 

model statements 
ENDM 

MuauaMaMassisB>assaasiaMaiasssra>aauum«uawanaiaau 

The "ENDM" pseudo-OP must he used to let the macro processor know wh^t 
Is the last macro model statement. 

Macro Definition Examples 

This macro will move a block of memory from one location to another. If 
the "length" parameter 1s omitted, then a value of "255" will be used: 

MOVBLK 



MACRO 


#PM,#T0,#LEN*255 


LD 


HL,#FM 


LD 


DE,#T0 


LD 


BC,#LEN 


LDIR 




ENDM 





This 1s a macro to clear a region of memory (I.e. set to 0). This macro 
will Invoke the MOVBLK macro 1n a nested Invocation: 

CLRMEM MACRO #BUF,#LEN«255 
LD HL,#BUF 

LD (HL),0 

MOVBLK #BUF,#BUF+1,#LEN 
ENDM 

This macro will add the 8-b1t register "A" to 16-bit register pair "IC": 



ADDHLA 


MACRO 






ADD 
LD 
ADC 
SUB 


A,L 
L.A 
A,H 
L 




LD 
ENDM 


H,A 
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There is no requirement that a macro must contain 
evidenced by the last example. 



dummy parameters as is 



Incorporating Conditionals 






Conditional pseudo-OPs can be specified 1n macro models. For instance, 
say you want the MOVBLK macro to be able to perform a non-destructive move (a 
destructive move would be where the destination is an address between "from" 
and "from+length-1"). You can insert conditional pseudo-OPs to test the 
parameters during the assembly of the expansion (labels substituted for #FM 
and #T0 must be defined prior to invoking the MACRO). Then, only certain 
segments of the macro will be assembled according to the result ^^of the 
evaluation. Analyze the following example: 



MOVBLK MACRO 


#FM,#T0,#LEN=255 


IFNE 


#FM,#T0 


;Don*t expand if #FM=#T0 


LD 


BC,#LEN 


Establish the length 


IFGT 


#FM,#T0 


;Do we LDIR or LDDR? 


LD 


HL,#FM 


;#FM > #T0 *> LDIR 


LD 


DE,#T0 




LDIR 






ELSE 






LD 


HL,#FM+#LEN-1 


;#T0 > #FM »> LDDR 


LD 


DE,#T0+#LEN-1 




' LDDR 






END IF 






END IF 






~* ENDM 






MACRO NESTIN6 






iiaua»u«» 







The CLRMEM example depicts a macro that nests a macro invocation. Macros 
may be nested to seven (7) levels. That is, at any time, macro expansions for 
7 macros called in a chain can be pending. It is very important to note that 
macro definitions cannot be nested. For instance: 



ABC 


MACRO 


#PARM 




(model 


statements) 


XYZ 


MACRO 


#PARMs,. 




(model 


statements) 




ENDM 





ENDM 

is illegal and will result in an assembly error. It is entirely correct, 
however, to invoke a macro within a macro definition prior to the definition 
of the called macro. The called macro must, however, be defined prior to 
calling the first, or highest level, macro. For example: 
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ABC MACRO #PARMS,... 

(model statements) 

MOVE parm.parm jcall macro "MOVE" 

{mode! statements) 

JcWOM 

MOVE MACRO #parml,#parm2,#parm3 

(model statements) 

ENDM 

is perfectly legal. The expansion of the "MOVE" macro is not performed during 
the definition of the "ABC macro but rather during the Invocation of "ABC". 

If macro A "calls" another macro, say B, any dummy parameter 1n the 

macro call of B that matches a dummy In macro A, will be considered part of 

macro A and the parameter substitution will be Invoked by the parameter 
passed when the user calls macro A. . H 

MACRO INVOCATION 



i ne invocation ot a macro 1s termed a macro "call". The niacro processor 

thf m i^ C !?c S i°*r ep ] ace T . the cal1 w1th the model statements specified when 
ctM2SnJ« S + . def1 U e ?: The rep1 acement <> f ^e macro call by the macro model 
statements is termed the macro "expansion". - 

During the expansion, the "actual" parameters passed 1n the call 
statement are substituted for the "dummy" parameters which appear 1n the 
2E r °J5 de and Wh1 E h ^ designated in the prototype of the macrS. Note that 
the actual parameter values are character strings and can be labels 
UK*"} ?*'., °r dat ! constant s. An actual parameter can even be a quoted 
string data declaration if Its use 1s designed Into the macro model. 

tu . The entire expanded macro model 1s listed during the listing pass (phase 
two) of EDAS. You may find that you don't really want to see these expansions 

ashler swUcS "TOE ""*•];« ^ e fJ re 1^^tration%f the macro! °Xn 
assembler switch, "-NM" is provided in the <A>ssemble command to suppress 

I i!3i!li"5r K eXp ?! 8lon$ - In the case of nested macP0 Mlls d.«. ■ macro 
is defined which calls another macro which was separately defined) only the 
primary macro call will be listed If the " suppress " swl ten 1$ 1n!5td. 

^ac^l^u?*^ 1xSllSn a wh"enVracro HlH I? ** 

JI! specifies whigh actual psrmetcr egrrespondi to §ach duany pvaMtiF? 
There are two methods supported In EDAS. Parameters can be passed to the 
macro expansion when calling by either position or keyword. 
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Positional Parameters 



"Positional' 4 parameters are correlated by the position they appear in 
the macro call. For example, if the "MOVBLK" macro were called by the 
statement: 

MOVBLK VIDEO, CRT_BUFFER,CRTJIZE 

then the substitution string "VIDEO" would replace every appearance of "#FM\ 

the string "CRTJBUFFER" would replace every appearance of "#T0", and 

"CRTJIZE" would replace the dummy parameter, U #LEN". Note that actual 

strings' are positional ly correlated with the positions of the '"dummy 
parameters 1n the macro prototype. 

If you wish to omit an actual parameter 1n a macro call, then you must 
supply the comma to denote Its place. For instance: 

SHIFT 4200H..100H 

omits the middle of three parameters. Generally, a default would have been 
provided In the macro definition. 

Keyword Parameters 



If the number of parameters 1s large, 1t 1s sometimes burdensome to 
remember the order of the parametersi or to ; provide the correct number of 
commas 1f a series of parameters are omitted. These drawbacks are remedied by 
the use of "keyword" parameters. The macro call parameter 11st can identify 
the actual parameters by using the name of the dummy parameter as well. The 
keyword syntax 1s: 

■uuuaMUNaaMiauaatai»aiwaiu uaMnauan 

#dummy»actual parameter 
mname #parm2»actual2,#parm3»actual3 



If the previous macro call was Invoked by keyword parameter 
specification, 1t could look something like this: 

SHIFT fLENsl00H.#FM"4200H 
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Mixing Positional and Keyword Parameters 

A single macro Invocation can intermix both positional and keyword 
parameters. The point that needs clarification, 1s what positions are 
actually denoted 1n the parameter list. It is simply treated. In a mixed 
parameter 11st, keyword parameters are ignored when considering place 
positions. For example, in the following macro call: 

SHIFT #LEN»100, BLOCK, BUF^START 

even though the length parameter appeared first .In the parameter list, since 
1t was designated as a keyword, 1t 1s Ignored from the positional count and 
"BLOCK" is the first parameter with "BUF START" taking up second place. in a 
similar manner: "" ^ 

COW PARM1,#P6*2,,PARM3,#P8«38,PARM4 

"PARM1" 1s in position one, the second parameter 1s omitted (the double 
comma), "PARM3" and PARM4" are 1n the third and fourth positions 
respectively. The sixth and eighth parameters have been entered by keyword. 

Please note that the parameter 11st contains five parameters. Thus 1f 
you were to use the "%%" operator which returns the number of parameters 
passed In a macro call ("%%" is described later), it would return a value of 
five. 

LOCAL LABELS 



So far, all of the examples have shown macro models without labels. What 
would happen 1f we had a macro defined as follows: 

FILL MACRO #CHAR,#NUM 

LO B,#NUM 

FLP LD (HL),#CHAR 

INC HL 

DJNZ FLP 

ENOM 

We would have a problem because every time the" macro was called, the label, 
"FLP", would be used. If "FILL" was Invoked more than once, the assembler 
would generate MULTIPLY DEFINED SYMBOL errors on each expansion. We have to 
be able to use labels, but we need to find a way to be able to make "unique" 
labels on each macro expansion. 

EDAS provides a facility for doing this by keeping a substitution string 
which 1s changed each time a macro 1s expanded - any macro. The substitution 
string replaces the question mark character, "?", during the macro expansion 
whenever It appears outside of single quotes 1n a macro model statement. Each 
time a macro 1s expanded, the "value" of the string will be changed. The 
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Micro Processing 

"value" starts with the single letter "A", changes to "B", .... "Z", then 
increments to the two-letter strings, "AA", and changes to "AB", "AC", ..., 
"BA", .... "ZZ" each time a macro call 1s made. Thus, by incorporating the 
question mark as one of the characters 1n the label of a macro model 
statement, it can be used to uniquely identify labels local to a macro. You 
may want to standardize the way you create labels to ensure that uniqueness 
is maintained. For example, 1f you use macro labels of the form, M $$?l", 
"$S?2", .... these will expand to "$$AAl\ "$$AA2", ... within one macro 
during Its first expansion. The second macro expansion will create "$$AB1", 

"$$AB2", ... You can then repeat the use of "$$?1", "$$?2" 1n another 

macro since for each macro expansion, the substituted string will be 
different. 

The substitution string will be different from the "*M00" directive 
substitution but 1s similarly used. Macro expansion substitution of "?" takes 
precedence over *M00 substitution* In the case of nested macros, each nest 

level will have Its own unique substitution (since each nest is a macro call 
which Invokes an expansion). 

The macro substitution string can be prefixed with a user-entered 
character constant. This is achieved by using the "*PREFIX" assembler 
directive as in: 

*PREFIX character-expression 



where the expression character or value 1n the argument becomes the prefix 
character (it must be valid for assembler source labels). For example, 
V_ "*PREFIX •$•" will cause macro local label string substitution to be expanded 
as "$AA", "SAB", "SAC", ... A binary zero value will eliminate any prefix 
character once invoked. 

By using the question mark string substitution specifier, the previous 
macro would be defined like this: 



'ILL MACRO 


#CHAR,#NUM 


LO 


B,#NUM 


>$?1 LO 


(HL),#CHAR 


INC 


HL 


DJNZ 


$$?1 


ENDM 


='■',;;> 'CM';.. ■■ 
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STRIPS COMPARISONS 

BSBittsnaraaiaasa 



It 1s sometimes desirable to be able to test within a macro model, the 
exact string passed as a parameter. Four conditional pseudo-OPs have been 
added strictly for string comparisons within macro processing. These are: 



1 IFLT$ 


strlngl, string2 


1 IFEQ$ 


Str1ngl,str1ng2 


1 IFGTS 


strlngl, str1ng2 


1 IFNEJ 


Stringl,string2 



TRUE 1f strlngl < str1ng2 
TRUE 1f strlngl ■ str1ng2 
TRUE if strlngl > string2 
TRUE if stringl <> string2 



*t 



These pseudo-OPs provide TRUE/FALSE evaluation 1n the comparison of 
strlngl to str1ng2 (like the non-*$" pseudo-OPs do with mathematical 
expressions). Obviously, hard encoding of both strlngl and string2 would be 
nonsense! Aha, he said... If we use a macro dummy parameter, It will be 
substituted by the actual parameter string passed 1n the macro call 
expansion. This means that the macro Itself can test the parameter string 1n 
a limited manner. For example: 



IFNES 

LO 

ENOIF 



#T0,(DE) 
DE,#TO 



as part of a macro model, will have the "#T0" replaced during the expansion. 
The test becomes dynamic! The dummy parameter can be either strlngl or 
str1ng2 - 1t doesn't matter. a 

These string conditional pseudo-OPs can only be useful In macros. That's 
because the evaluation, to make sense, has to be dynamic. 
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TESTING STRING LENGTHS 



Another feature available in the macro processor is the per cent sign 
"X" operator. This operator is used to recover the length of the passed 
parameter string and the number of parameters passed in the macro call. Note 
that the limitation for the use of the "X" operator, is that it is acceptable 
only fqr parameters of the current macro expansion. That means that you can't 
test for lengths outside of the current macro if you are nesting macro calls 
(macros cannot be recursive!). The operator can be used like these examples: 

LD B,X#PARM ; loads B with the length of #PARM 

IFGT X#PARM1,6 Restricts parml to a length <l-6/* 

ERR Parm too longl 
END IF 

IFLT XX,4 ;This macro requires 4 actual parms 

ERR Missing required parameters! 

ENOIF 

As can be noted, the "%% u operator will return the number of parameters 
passed in the current Macro call. When a dummy parameter name (including the 
y prefix) follows the per cent operator, the length of the parameter string 
1s returned. a 

These values can be tested arithmetically to produce a TRUE/FALSE result 
(as was just demonstrated), or they can be used directly to represent logic 
TRUE/FALSE conditions. Realizing that 1f a parameter was not passed in the 
parameter list of the macro call, its length would be zero. A zero is also a 
logical FALSE. EDAS will accept as TRUE, any non-zero value (in normal use of 
TRUE/FALSE specifications, M -l" is recommended for TRUE to maintain proper 
evaluation of the ".NOT." operation). Thus, the string lengths can be 
minimally used to test 1f the parameter was not passed (X#parm«0-FALSE) or 
the parameter was passed (X#parmO0»TRUE). 

CONCATENATING MACRO LABELS 



You can concatenate a string to a dummy parameter name by connecting it 
with the concatenation operator, "X& M . For Instance, the model statement: 

IFREF #NAMEX&L 

will have the M #NAME M replaced by the MACRO call substitution string appended 

with the letter M L B . 
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The EDAS Version IV Editor Assembler can perform the following commands. 
These commands may be typed after the prompt symbol ">". The prompt symbol 
appearance indicates the "command mode" of the Editor Assembler. The 
following list contains all command mode instructions recognized by the 
Editor Assembler with a brief description of each. 

A <A>ssemble source currently in the text buffer. 

B <B>ranch to a specified address. 

C Slobally <Ohange a string of characters (STRING1) to another string of 
characters (STRING2) throughout a range of text lines. 

C <Oopy a block of lines to another location. 

D <D>elete specified line(s). 

E <E>dit a specified line of text. 

F <F>1nd a specified string of characters. 

H Provide <H>ard copy output (line printer) of a specified range of text 
buffer lines. 

I <I>nsert source text line(s) at a specified line with a specified line 
number Increment. 

K <K>111 a file from a diskette. 

L <L>oad a source text file from disk. 

M <M>ove a block of text from one location to another. 

N Re<N>umber source text lines in the text buffer. 

P <P>r1nt a specified range of source text code currently in the text 
buffer. 

Q <Q>uery a directory from the designated drive. 

R <R>eplace lines currently in the text buffer. 

S <S>witch the upper case/lower case conversion mode. 

T <T>ype source text lines without line numbers to a line printer. 

U Display the memory <U>tilization - bytes used by the text, bytes 
available, and the first free address. 

V <V>iew a file without loading it into the text buffer. 
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W <W>r1te the current text buffer to disk. 

X e<X>tend the text buffer by eliminating the Assembler. 

Z Command reserved for user. 

1 Alter printed lines per page and page length. 

Send a message to a Job Log (LOOS' only). 

CLEAR Clear the CRT screen. 

UPARW Scroll up one source text line. 

DNARW Scroll down one saurce text line. 

LTARW BACKSPACE key 

RTARW TAB key 

SRARW Page forward one screen. 

PAUSE Performs a functional pause of any operation: <SHIFT (Model I/III)> 
<H0L0 (Model II )> for the PAUSE function). 

UPARW ■> the up-arrow key 

DNARW «> the down -arrow key 

LTARW «*> the left-arrow key 

RTARW ■> the right-arrow key 

SRARW »> the shifted right arrow key (F2 on Model II) 
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<A>SSEMBLE 



The <A>ssemble command is used to invoke the assembly of your source 
stream from memory and optionally, disk files (when "*GET filespec" or 
M *SEARCH library" is used in the source stream). The <A>ssemble command is 
also used to create a cross reference data file for downstream processing by 
the XREF/CMD program which will create a complete symbol cross reference 
listing. The syntax of the <A>ssemble command is: 



V 



A {filespecl/CMD}{,filespec2/REF} {-SWITCH {-SWITCH}...} 

fllespecl is the filespec to be used for the object code 
file generation. If the file extension is 
omitted, VCMD" will be used (see -CI). 

f1lespec2 is the filespec to be used for the cross ref- 
erence data file. If the file extension is 
omitted, VREF" will be used. 

Swi tches : 

-C| used to generate a Core-Image object file. 

-IM used to assemble the object code Into Memory. 

-LP used to generate a Listing to the Printer. 

-NC used to suppress the listing of conditional 

blocks evaluated to be logically FALSE. 

-NE used to suppress the listing expansion of data 

declaration pseudo-OPs. 

-NH used to suppress writing the header record to 

the object code file. 

-NL used to suppress the listing pass. 

-HM used to suppress listing MACRO expansions. 

-NO a dummy switch useful as a default switch in 

JCL execution of ED AS. 

-SL used to suppress local label listing 

-WE used to pause the assembly listing and Wait if 

an Error occurred. 

Parameters continued next page 



^ 
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-WO used to assemble With Object code generation. 

-WS used to generate a sorted symbol table listing 
during the assembly process. 

«XR used to generate a cross reference data file 
for subsequent processing by XREF/CMD. 



The <A>ssemble command can be used to generate object code, Into either 
an executable object code file (/CMD) or a binary core-image object code ffcle 
(/CIM). Your program can also be assembled directly Into the unoccupied 
memory region when the memory locations to be occupied by your program are 
not 1n conflict with storage areas of the assembler, your resident source 
code, the MACRO storage area, or the symbol table. 

The source text to be assembled can exist either 1n memory only, or a 
combination of memory and disk files. The 1n-memory source 1s considered to 
be 1n the "text -buffer". When your source program 1s too large to be 
contained solely 1n the text buffer, 1t needs to be segmented Into a 
combination of a memory segment and one or more disk file segments. The disk 
file segments are accessed during the assembly process by use- of the "*GET 
fllespec" assembler directive (detailed Instructions concerning the use of 
*SET, are contained 1n the chapter entitled "ASSEMBLER DIRECTIVES"). 

The following paragraphs describe the command line entries and switch 
options In detail. Please note that If the EDAS e<X>tend command has been 
Invoked, the <A>ssemhle command will be Inoperative. 

Fllespecl 



The first fllespec on the command line, Identified as "fllespecl", 1s 
the fllespec to be used for the object code file. Its entry 1s entirely 
optional. When an object code fllespec 1s entered, Its entry will 
automatically invoke the generation of the object code to the disk file. 
Another method can also be employed to Invoke object code generation to a 
disk file by means of the "-W0" switch (see below). If your fllespec entry 
omits the file extension, the default of "/CMD" will be used. This default 1s 
changed to "/CIM" 1f the "-CI" switch 1s specified. It Is recommended that 
you let the assembler assign the file extension, automatically. It will help 
to keep your directories orderly, and there will be less danger of 
overwriting a source file with the object code file. 

F1lespec2 

The second fllespec on the command line, noted as "f11espec2", 
Identifies the fllespec to be used when writing the cross-reference data. The 
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cross-reference data generation is optional - it is required in order to run 
the XREF/CMD program. EDAS will assign a default file extension of *7REF M if 
you omit the extension from your filespec. As XREF/CMD will also use this 
extension when accepting the file specification, it is suggested that you let 
EDAS assign it. You can also invoke generation of cross-reference data by 
using the "-XR" switch (see below). EDAS requires the entry of the comma to 
recognize the cross-reference filespec as "filespec2". Therefore, if you want 
the cross-reference data file but not the object deck file, then either start 
the command line with the comma separator or use the XR switch without 
entering the fllepec with the command line. 



Switch -CI 



■**v 



The "-CI" switch 1s used to generate a "core-image" object code file. 
Executable command files 1n LDOS are constructed with address information 
that the system loader uses when loading and executing your command file. 
Also, a header record is usually found in a load module object code file. 
There are times when you would prefer an object code file without this "load" 
and "comment" data. For example, say you want to burn a Programmable Read 
Only Memory (PROM) from a file. A core-image file is needed. When the "-CI" 
switch is specified, a number of changes take place in EDAS. First, the 
object code file default extension 1s changed to "/CIM" (note: you must stm 
enter the filespec or the switch "-W0" to Invoke object code generation). 
Next, the header record and the transfer address record are suppressed. Any 
COM pseudo-OP statement is, likewise, suppressed. A core-image file needs to 
contain contiguous address sequential code. Since EDAS reserves only storage 
locations when assembling the DS/DEFS pseudo-OPs, the DS instruction would 
cause your object code file to be non-contiguous. Invoking the "-CI" will 
automatically convert all "DS" statements to their corresponding "DC" 
statements with a zero value for operand2. 

Switch -IM 

This switch will invoke object code generation; however, instead of the 
code being written to a file, 1t 1s placed into memory starting at the 
address specified as the operand of the "ORG" pseudo-OP. The "-IM" switch 
will override the entry of the "-W0" switch or entry of "fllespecl". That 1s, 

if both MM" and M »W0" (or fllespecl) are entered, assembly into memory will 
occur and assembly to disk will NOT take place. 

Your program will not be permitted to overwrite any region below the end 
of the text buffer (or macro storage area if macros are being used) nor will 
it be permitted to overwrite the symbol table stored in high memory. The 
error message, 

Meawry overlay aborted 

will be displayed if your assembled program will violate these restrictions. 
The assembly will be immediately stopped and EDAS will return to the command 
ready prompt. Upon successful completion of the assembly to memory, the 
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message, 

Memory region loaded 

XXXX Is the transfer address 

wm be displayed, This does not mean that your program assembled without 
error - only that the object code generated did not "interfere with the text 
buffer or tables created during the assembly process. The "XXXX" field 1n the 
second message will contain the transfer address of the program. It will be 
listed 1n hexadecimal. 

Switch -LP 

The "-LP* 4 switch 1s used to send the assembler listing, error message's 
occurring during the assembly of your source code, and the symbol table 
listing (1f specified by means of the M -WS" switch) to a line printer. EDAS 
assembler listings print 56 lines per page and send a form feed at the 
conclusion of the 56 lines. If you are generating a listing output and a 
properly paged display Is desired, 1t 1s suggested that you set your paper to 
begin printing at the sixth line from the top of the page (which assumes 

default). This will provide five blank lines for a top margin, and five blank 
lines for a bottom margin. 

If you are using other than 11" form paper, use the EDAS "command "<1>" 
to alter the paging parameters to suit the specifications of your printer. 

Switch -NC 

Conditional assembly (see the chapter on ASSEMBLER PSEUDO-OPS) can 
greatly ease the maintenance of programs designed to work with multiple 
configurations of hardware. However, It 1s unnecessary to "see" the source 
statements within conditional blocks that are logically "false". This "-NC" 
switch 1s provided to have No "false" Conditionals appear 1n your listings. 
If a conditional 1s suppressed, neither the "IF" statement nor the "ENDIF" 
statement of the "false" block will be listed. 

Switch -NE 

Various data declaration pseudo-OPs create a structured format for the 
listing of code generated after the first byte of the statement. These are 
! he « JJ/JEFB, DH/DEFM, DW/DEFW, and the DC pseudo-OP statements. If you want 
to Inhibit the expansion from the listing only (the code will still be 
expanded for assembly of object code), then specify the No Expansion, "-NE\ 
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Switch -NH 

Object code files usually start off with a header record of X'05 06 xx 
xx xx xx xx xx*. The x's would be replaced with the first six characters of 
the object code filename (buffered with spaces). EDAS automatically generates 
this record when writing the object code file. The DOS loader has no problem 
with this record. If you would like your object code files to contain this 
record, then do absolutely nothing. If you do not want to have this header 
record generated, then specify the No Header, "-NH", switch. 



Switch -NL 



*'*•? 



The second phase of the assembly process generates the assembler 
listing. That 1s the only purpose 1t serves. If you do not want to see a 
listing, then you may enter the No Listing, "-NL", switch. This will 
completely suppress phase two and shift the assembler to phase three (if 
object code generation had been specified. If you are interested in listing 
statements containing errors, then you must not suppress the second phase. 
Note that only the lines containing assembly errors can be listed by 
specifying the "*LIST OFF" assembler directive. See the chapter on ASSEMBLER 
DIRECTIVES" for further details. 

The cross-reference data file 1s written during phase two. In order to 
guarantee that the second phase is available, a cross-reference specification 
will automatically override any entry of the "-NL" switch. This could be 
useful during a job stream assembly (from Job Control Language) where 
selected assemblies need the cross-reference data. Thus, your JCL could 
specify "-NL" for every assembly; whenever the XR option was invoked, phase 
two would not be suppressed. 

Switch -NM 



You have read about the powerful uses made of macros 1n the MACRO 
PROCESSOR chapter. By now, you may have realized that the macro model code is 
repeated whenever you Invoke the macro. Once you become familiar with what 
the macro does, you really don't need to see Its expansion in your listings 
every time the macro 1s Invoked. Switch "-NM" has been provided to inhibit 
the listing of such expansions. If you specify No Macro expansions, only the 
statements invoking the macros will be listed - the listing of the expansions 
will be Inhibited. In the case of a nested macro Invocation, only the highest 
level macro call will be listed. 

Switch -NO 



Previous versions of EDAS, and other assemblers (are there any other?) 
have used a switch designated "-NO". Its use was to inhibit the generation of 
object code (No Object) when the assembler automatically generated the object 
code. Since EDAS does NOT generate object code unless you tell it to do so 
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(by "filespecl", switch "-W0", or switch "-IM"), the "-NO" switch is ^ 

unneeded. There are those "old dogs" that cannot learn new tricks. Therefore, *., 

-..s*tftch I <£*J!IO l, 4 has. been- included Just in case -jyosi have "'the habit of entering. ) 
-NO, However, it does absolutely NOTHING! 

An alternate use can be made of the "-NO" switch when operating EDAS 
from Job Control Language. This was addressed in the chapter entitled, 
RUNNING EDAS. 

Switch -SL 

If you specify "-SL", then any label starting with a dollar sign, "$", 
will be suppressed from the symbol table listing and from any cross-reference 
data file. Therefore, use of the "$" as the first character of local labels 
and specifying "-SL" will result in keeping your symbol table listings 
uncluttered with local labels - especially true with the LC compiler. 

Switch -WE 

In a long assemblyg you may want the ■ assembler to pg^se the listing 1f 
it detects an assembly error (you're bound to get some of them). The Wait on 
Error switch, "-WE", is available for that purpose. If specified, each time 
the assembler comes to an error during phase two, It will pause the listing. 
Any character entered from the keyboard will continue the assembly and 
listing. If you choose to enter the character "C or "c", then the phase two , 

process will "Continue without further Interruption - even though additional k 

errors may be detected. The listing may also be paused at any time by •' 

depressing the <PAUSE> key, momentarily. 

Switch -WO 

*mwmmm,m>mm**mmim 

As noted in a preceding paragraph, object code generation is specified 
^ ei L " f i!f? pe £j!! 1s enter *ed. Assembled object code 1s also generated to disk 
if the With Object switch, "-W0" is specified. If "filespecl" has not been 
entered, the prompt message: 

Ob J filespec? 

will be displayed. Enter the object code filespec that you want to use to 
save the assembled object code command file at this time. If you do not enter 
Jo 1 ?* f^? 081011 * the default VCMD- will be assummed. EDAS will open the 
Tile JT It is m existing file and display the message, Replaced, or create 
the file 1f It Is non-existant and display the message, New file. 

If you enter "filespecl", 1t 1s not necessary to enter the "-WO" switch 
as entering the object code filespec will activate the "-W0" switch. If the 
switch, MM", is specified denoting an in-memory assembly, the "-W0 a switch 
will be ignored. 






CQvmMm 

7 



J 



V 



Editor Assembler Commands 
Switch -WS 



A complete symbol table cross-reference listing is available via the 
"-XR" switch and subsequent processing by the XREF/CMD program. Such a 
separate process is needed in order to be able to handle cross referencing of 
statements fetched from a *GET or *SEARCH file. An abbreviated printout that 
contains only a sorted listing of symbols and their value is available at 
assembly time by invoking the With Symbol switch. "-WS". The symbol table 
listing would normally be displayed on the video display. If the "-LP" switch 
was specified, the listing would be directed to the Line Printer. 

Switch -XR ^ 



This is the switch option to use if you want to generate a complete 
symbolic cross reference listing. Switch "-XR" will invoke the generation of 
a reference data file used by the XREF/CMD utility (see the chapter on CROSS 
REFERENCE UTILITY). The reference data file is generated during the listing 
pass (phase two). If the XREF filespec is entered with the command line, this 
switch is assumed to have been entered. If the XREF filespec is not entered 
with the command line, the filespec of the reference file will be prompted 
for with the query, 

XREF Filespec? 

Respond with the filespec that you want to use to store the reference data. 
If you do not enter a file extension, the default VREF" will be assumed. 
EDAS will open the file 1f 1t is an existing file and display the message, 

Replaced 
or create the file if if it is non-existant and display the message, 

New file 
Error totals 



At the conclusion of phase three which generates object code, a listing 
of the total number of errors will appear. This error total will be displayed 
after the conclusion of phase two if object code is not generated. If you 
need to get a quick Idea whether or not your source code contains errors, 
place an "*LIST OFF" pseudo-OP at the beginning of your code and omit any 
object code generation - but do not specify "-NL". Only lines containing 
errors will be listed. You could also specify switch H -WE" to pause when an 
error occurs [Note: If you specify -NL and do not generate object code, the 
Error totals" will be incorrect (the number of forward references plus any 
other errors will be displayed)]. H J 
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<B>RANCH 



The <B>ranch command is used to exit EDAS. Since the <B>ranch command 
permits an address as an optional parameter, you can use it to jump to any 
address (the entry to an in-memory assembled program 9 for instance). The 
syntax of <B>ranch is: 



I I 

I B {address} I 

I I 

I address is the branch address entered in hexadecimal. | 



This command is used to exit the Editor Assembler or optionally branch 
to any user designated address. If a branch address is omitted, a return to 
the DOS Ready command mode is performed. If a branch address is provided, the 
top of the stack will contain a re-entry address to EDAS. This can benefit 
the testing of a program assembled into memory. A simple "RET" instruction in 
your program will return control to EDAS (provided your program maintained 
stack integrity and did not crash). 

Examples of the <B> ranch command: __ 

B 



B 9000 



"B" by itself will cause an exit from EDAS and return to DOS 



This command will cause an exit from EDAS and branch to your program 
at X'9000' (it is hoped that your program is there). 



B 5806 (Model I/III) or B 3706 (Model II) or B3606 (LDOS 6.x) 



30 



This will invoke a jump to the warmer-start vector which 
reinitializes EDAS and clears the text buffer. 



This branch will cause EDAS to enter DEBUG (Model I/III or LDOS 6.x 
only). The Program Counter as displayed by DEBUG can be used as the 
return address to EDAS. Optionally, you can "Go" to X'5803 1 (Model 
I/III) or X'3603' (LDOS 6.x) or X'3703' (Model II). 
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<OHAWSE 



The <C>hange command performs a global modification of a string of 
characters. Its syntax is: 

nna»tiiumHunu»:»xiHS»i3snus3»33sx3isax*sinui 

C /Str1ngl/string2</nl,n2} 

stringl 1s the current string to change. 

is the replacement string for stringl. 



str1ng2 
nl 

n2 
/ 



1s the line number of the line preceding the 
first change (FIND always starts at I1ne+1). 

1s the line number of the last line to change. 

represents a string separator character. It 
can be any character except a digit <0-9>. 



v.. 



A string of characters can be changed throughout the text buffer by this 
one easy command. The global <Ohange command will change the appearances of 
"stringl" to the sequence "string2". Because <C>hange uses the <F>ind command 
to locate strings and the <F>ind command always starts searching at "current 
line + 1", no changes can be performed on the first line of the text buffer - 
at least not with the <C>hange command. Also, only the first appearance of 
"stringl" in each line that "stringl" appears will be altered. 

The first non-blank character following the "C" becomes the string 
delimiter (the slash character is shown above; any character except a digit 
<J9-9> is permitted). Null strings are not permitted (I.e. the string must 
contain at least one character). 

There 1s no requirement for "string2" to be the same length as 
"stringl". It can be of lesser, equal, or greater length; however, no string 
can exceed 16 characters in length. If a change would result in a line 
exceeding the maximum line length (which is 128), the change will not be 
performed on that line and the message, 

Field overflow 

will be Issued. The search for "stringl" continues for the remaining lines. 

A line which contains "stringl" will be displayed as it exists both 
before and after the change. The <SHIFT-@> key may be used to pause the 
display. If you depress the <BREAK> key, it will stop further changing. 
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The entry of "nl" and "n2" Is optional. If "nl" 1s entered, then "n2" 

S'ih 'k e ? te ^* V " either " nl " nor * n2 * 1* e^ered, then -nl- Is assumed to 
be the beginning of the text buffer (# or t) and "n2" Is assumed to be the 

SSrSt *!? t6 f h?"^^ i\ or b) * E1ther Hnl " or " n2 " carl be enlered 'as the 
current line Indicator (.). You can enter "nl" as (# or t) to Indicate the 

5S ""l" 9 *?* Z°L of fc 5 e text buffer while " nZU can be entered as (* " b) to 
mcncate the bottom of the text buffer. One additional restriction ic thai- ie 
you enter «n2" as -b- or «*«, then no change 3ll IT IdTon the lasl Unl or 

When EDAS 1s set to the -lower-case converted" mode (see the Information 
S!! C8r ?l!! B * the " <s>wi tch-case« command), both -strlngl- and "string" ™n be 
Z"Zi% 1° U K Pper ? ase ch *^ter S Prior to the selrch and replacement If 
you need to change lower case characters as well, then you must switch EDAS 
to the "lower-case permitted" mode prior to Issuing the <C>hange command. " 

m*n Th ! /J ab ; H character is a perfectly acceptable character to be used 
with n "stringl" or "string2". This may be useful 1f you want to convert a 
contiguous sequence of spaces to a single tab. convert a 

Examples of the <C>hange command: 

C /MODIFY/ALTER/ 

This command will change all appearances of the string "MODIFY" to 
the string "ALTER". 

C .DEFB.DB.90,1000 

This command will change all appearances of "DEFB" to "DB" from line 
100 to line 1000 (assuming 1nc-l0). ® 

C /DEFM/DB/90,b 

■21 tVni^f fST 1 *!! 111 translate a11 appearances of "DEFM" to 
DB trora line 100 to the end of the text (assuming inc-10). 
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<O0PY 



The <C>opy command can be used to duplicate a line or block of lines 
from pne point 1n the text buffer Into another point 1n the text buffer. Its 
syntax 1s: 

niUIUIIIUIUIIIUIUIUIUIIIUlUHluuHUIUIUIMnUI 

I 

C I1nel,l1ne2,11ne3 I 

llnel 1s the first line of the block to duplicate. I 

11ne2 1s the last line of the block to duplicate. I 

I 
11ite3 1s the line number of the line that the copied | 
block should follow. 



This command 1s useful to duplicate a line or block of lines. Note that 
the command letter 1s the same as the <C>hange command. EDAS will interpret 
the <C> as a <C>opy command 1f the first non-blank character following the 
<C> 1s a digit <0-9>. At the conclusion of the <C>opy operation, the entire 
text will be renumbered using the Increment currently in effect. A few 
restrictions are In order. A <C>opy cannot be performed 1f "line3" 1s 
Interior to the block "Hnel"-"11ne2\ "Llnel" must either precede "I1ne2" or 
be equal to "I1ne2" (where "llnel" 1s equal to "11ne2", the block to be 
duplicated consists of the single line, "llnel"). 

If insufficient space is remaining in the text buffer to duplicate the 
entire block, none of the block of lines will be copied and the message, 

Text buffer full 

will be displayed. The parameters (line numbers) must specify specific lines 
in the text buffer. If any of the line numbers cannot be found, the copy will 
not be performed and the massage, 

No such line 

will be displayed. The <C>opy command requires all three parameters entered 
and separated with the comma (,). If this syntax 1s not met, the message, 

Bad parameters 

will be displayed. 
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Examples of the <C>opy command: 

C 100,200,1000 

This command will duplicate the block of lines numbered from 100 to 



C t.50.50 

This command will copy the block of lines from the top of the text 
through line number 50 so that it will also follow line number 50. 

c 580,700.b 

This <C>opy command will duplicate the block of lines numbered from 
580 to 700 so that they also appear after the current bottom of text. 
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<0>ELETE 



The <0>e1ete command is used to remove a line or block of lines from the 
text. buffer. Its syntax 1s: 



{I1nel{,l1ne2}> 

Unel 1s the first line to delete. 

I1ne2 1s the last line to delete. 



n 



^ 



This command 1s used to delete the line or lines specified from the 



source text buffer. The characters 



or "t" are used to Indicate the 



beginning of the text buffer when used for "linel". The characters "*" or "b" 
are used to Indicate the bottom of the text buffer when used for "I1ne2". If 
the line parameters are omitted, the current line, "." is as summed. 

To aid 1n you 1n observing what becomes the new current line after a 
line delete operation, the new current line will be displayed. 

Examples of line deletes: 



100,500 

This <D>elete will remove from the text buffer, lines 100 through 500 
(Inclusive). 

D T,B or d t,b or d #,* 

This command will remove the entire source text from the text buffer. 
A <B>ranch to the "warmer" start address also will delete the entire 
text. 

D or d 

This <D>elete command will remove the current source text line. A 
period, ".", may also be used to Indicate the current line (I.e. 
"D."). 



105 



This command will delete the the single line numbered 105. 
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<E>DIT 



The <£>dit command 1s used to invoke the line editor for purposes of 
making alterations to a single text line. Its syntax is: 



/ 



E {line} 
line 



1s the number of the line to edit. 



This command permits the user to edit or modify any source text line. 
The syntax and function of all edit subcommands are Identical to those 
implemented 1n the BASIC editor. If the optional line number Is not entered, 



the current Une, 



will be edited. 



When using the line editor, it will always operate 1n the "lower-case 
permitted" mode. Therefore, you will need to pay attention to use of the 
<SHIFT> key when editing upper-case characters. However, once you complete 
your editing and exit the line editor, your Une will be properly converted 
to upper-case as required 1f EDAS 1s 1n the "lower-case converted" mode. 
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The following table of Edit Subcommands are provided for a reminder of 
the common edit operations: 

■■(»lIIIIIHtWaiHUlUI»SUX3M»»3II»»mUI3XU»UltU 



A 

nC 

nO 

E 

H 



I 
ntCx 



Q 

nSx 

<— 

ENTER 

ESCAPE 
SPACE 



Abort and restart the line edit. 

Change n characters. 

Oelete n characters. 

End editing and enter the changes. 

Delete (hack) the remainder of the line and 
Insert the following string. A line hacked to 
zero length will be automatically deleted when 
exiting the line editor. 

Insert string. 

Kill all characters up to the nth occurrence 
of x. 

Print the rest of the line and go back to the 
starting position of the line. 

Quit and Ignore all editing. 

Search for the nth occurrence of x. 

Hove edit pointer back one space. 

Enter the line 1n Its presently edited form 
and exit the edit mode. 

Escape from any edit mode subcommand. The 
<SHIFT-UP-ARROW> key 1s the escape key on 
the Model I and Model III. 

Display the next character of the current 
line being edited. 
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<F>IND 



The <F>1nd coranand 1s used to locate the next occurrence of a string of 
characters within a line. Its syntax 1s: 

zuuiauixsaiisssssssiBiszassaiiiiaiiSiiavsiasssgsissssBsasaaassss 
I • I 

F {string) 



I string 1s the character sequence to find. | 



The text buffer 1s searched starting at the current "11ne+l" for the 
first occurrence of "string". "String" can be from <1 to 16> characters in 
length. If more than 16 are entered, then any characters beyond the 16th will 
be ignored. If no string 1s specified, the search is the same as that of the 
last <F>1nd command 1n which a string was specified (provided a global 
<C>hange command was not performed after the last <F>1nd command). If the 
search string 1s found, the line containing 1t 1s displayed and the current 
line pointer 9 ".", 1s updated to point to the displayed line* If the string 
is not found, the message, 

String not found 

Is displayed and the current line pointer, ".", remains unchanged. A "P#" or 
"Pt" command can be used to position the line pointer to the top of the text 
buffer prior to use of the <F>1nd command. Spaces and tabs are considered to 
be part of "string" and are thus acceptable for "finding". 



Examples of the <F>ind command: 



» m <w «*«» t» at «o v*m<m tw tm n» <m> w <m <t» <on m> «a» 



FWRITEWORD 



This <F>ind command will locate the next appearance of the string 
"WRITEWORD". 



Assuming a <C>hange command has not been performed, this command will 
find the next appearance of "WRITEWORD". 
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<H>ARDCQPY 



This command lists a line or block of lines on a line printer to provide 
a "hard copy". Its syntax is: 

IUUIUWUnilUIUIHHMIIMUUaiiH||U|i|||| MHnnn| 

H {I1nel{ f line2}> I 

line! 1s the line number of the first line to print. | 

I1ne2 1s the line number of the last line to print. P 

I 



This command will print a line or a group of lines to a line printer. 
EDAS will print 56 lines to a page (see the discussion of the <1> command). 
If a properly paged display is desired, it is suggested that you set your 
paper to begin printing at the sixth line from the top of the page. 

Examples of the <H>ardcopy command: 

H #,* or H t,b 

This command will print the entire text buffer. 



H. 



This command will print lines numbered 100 through 500 inclusive. 



This command will print the single line pointed to by the current 
line pointer, ".". 



This command will print the 15 lines (Model II and LDOS 6.x print 23 
lines) starting with the current line. 
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<I>NSERT 



This command is used to invoke the <I>nsert mode so lines can be input 
into the text buffer. <I>nsert 1s somewhat similar to the "AUTO" command in 
BASIC. <I>nsert's syntax is: 



I {line#{,1nc}} 



11ne# 



1s the number of the line that the insert 
should follow. 



■Inc changes the current increment to "1nc". 
Note: use <BREAK> or <SHIFT-CLEAR> to exit 

■aaasassssa>sasaassBB.B>asai>BsaBSBBsaaa«8SBSs«a8ssanaaaaiasai>a 

The Insert command 1s used to Insert or add text lines into the text 
buffer. All lines of source text are entered with the use of the <I>nsert 
command. After using the <I>nsert command to specify where you wish to place 
new lines, the editor will generate the designated line number and allow the 
inserting of that numbered text line. After entering the first text line the 
editor will generate the next line number higher, as specified by your 
increment selection. Incremental line numbers will continue to be generated 
as long as there is room between lines or room left in the text buffer. 

If a desired Increment 1s not specified, the last specified increment 1s 
assumed. Period, "..", may be used for "I1ne#" to Indicate the current line 
or 1f "I1ne#" 1s omitted, the current line will be assumed. 

The <BREAK> key will allow you to leave the insert mode at any time. The 
<CLEAR> key also performs a functional BREAK. If you have entered the <BREAK> 
before depressing <ENTER> to complete the input of a line, that line will not 
get entered into the text buffer. 

Examples of the <I>nsert command: 



/ 



I 300,5 



IB 



This command will begin the text Insertion to follow line numbered 
300 and also change the increment to 5. 



This command will append new text to the end of the text buffer. It 
is identical to performing a "Pb" followed by an "I". 
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^ <K>ILL 



*N 



This command can be used to erase a file from a disk. It will function 
identically to the DOS KILL (or REMOVE) command. Its syntax is: 



I 

I K filespec 

I filespec Is the filespec of the file to be erased. \ 
I | 

I Note:. The file extension currently in effect for "source" |^ 
I files will be used as a default extension. 
! 1 

«IU*UMMUIlU»UUMM»UUIMlUUaiU« 



This command is used to delete a file that 1s not needed. Coupled with 
use of the QUERY command, file maintenance can be Implemented from within the 
Editor Assembler environment. This is especially useful when a <W>rite 
command results in a **DISK FULL** DOS error and you have to find a diskette 
with sufficient free space. 

In order to guard against Inadvertant use of the <K>11 1 command, a 
filespec must be entered. If no extension is entered, the extension currently 
1n effect for source files (usually "ASM" unless over-ridden by LC or EXT« 
parameters) will be assumed. If you enter the <K>111 command without a 
filespec, the message: 

{S&d parsaeterCs) 

will be displayed. 

Note: The <K>ill command is not available on Model II versions of EDAS. 
Therefore., one must use the <Q>uery KILL DOS command on the Model II. 

Examples of the <K>111 command: 



K 0LDPRQG/ASM:2 

This command will erase the file, OLDPROG/ASM, from drive 2. 
K TEST:0 

This <K>111 command will erase "TEST/ASM" from drive 0. 
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<1>0AD 

■■UN 



This command 1s used to load a source file Into the text buffer. Its 
syntax 1s: 



L {fllespec} 

fllespec 1s the fllespec of the file to be loaded. 



i*1> 



The <L>oad command will read the file denoted by the "fllespec" Into the 
text buffer. The text file will be concatenated to any text already 1n the 
text buffer. The file specification 1s composed of a FILENAME, optional 
EXTenslon, optional PASSWORD, and optional DRIVE reference as In: 

FIL£NAME/EXT.PASSWORD:D 

If you do not enter the "fllespec", EDAS will prompt you for the 
fllespec. If you omit the file extension (EXT), a default extension of "ASM" 
will be used thus saving keyboard Input and at the same time providing for a 
standard file naming convention. If the "LC" parameter was specified in the 
EDAS command line, then "CCC" will be used for the default. The EDAS 
parameter "£XT«ext" can be used to override the assigned default extension to 
that of "ext" (see the chapter on RUNNING EDAS). 

The <L>oad command will automatically handle a source file that is 
line-numbered and headered (EDAS Version III format), line-numbered and 
un-headered (EDTASM Series I format), or un-numbered and un-headered (EDAS 
■format, text editor* prepared files, or certain M~S# files). Model II source 
files created with EDAS 4.0 must be converted using the CONV40 utility. If 
the file being read is not line-numbered, EDAS will automatically number 1t 
as it loads. A line number counter Is kept internally that advances by the 
current increment for each un-numbered line read. Thus, concatenation of 
source text via multiple loads of un-numbered source files will produce a 
sequentially numbered 1n-memory text. The line number counter 1s reset to its 
initial starting value only by a warm-start or depression of the <CLEAR> 
command function. 

A line-numbered file 1s interpreted as one 1n which the first five 
characters of a line have the high-order bit (bit 7) set. The 5-character 
line number is also followed by a terminating character (usually a space but 
could be a tab with bit 7 set). A headered file 1s interpreted as one 1n 
which the first character of the file 1s an X'D3\ 



"ASCII" files prepared by a word processor program (I.e. SCRIPSIT) are 
loadable by EDAS; however, they must be pure ASCII and must have line lengths 
not exceeding 128. The only requirement 1s that there must be an end-of-f1le 
character as the last character of the text (which would follow a carriage 
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return). The end-of -character can be either an X*1A' or a null, X' 00'. EDAS 
can only convert lower case to upper case during <I>nput or <E>diting so 1f 
you use an external word processor program, keep the Z-80 code in upper case. 

Examples of <L>oad commands: 

L myprog 

This command will search for a file named "MYPROS/ASM" (assuming a 
default extension of "ASM") and load 1t Into the text buffer. 

L theprogil ^ 

This command will load the file named "THEPR06/ASM" from drive 1 Into 
the text buffer. 

Dt.b 

L newprog:2 

This sequence of commands will first clear the text buffer then load 
the file named "NEWPR06/ASM" from drive 2. 
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<M>0¥E 



This command Is used to <M>ove a Hne or block of lines from one text 
buffer location to another. Its syntax 1s: 

M Unel, Hne2, I1ne3 

Unel 1s the Hne number of the first line to move. 

Hne2 : 1s the Hne number of the last Hne to move. 



I 



!1ne3 



1s the number of the Hne that the block 
should follow after the move. 



aj 



This command 1s used to move a block of lines from one location In the 
text buffer to another. A large quantity of text lines can be moved to a 
jj ^f f gpgfit position in one easy operation. In the corosssnd syntax, l insx and 
"Hne2" are the beginning and ending line numbers of the text block to be 
moved. "Linel" and "Hne2 M are permitted to reference the same Hne number if 
only one Hne 1s to be moved. "L1ne3" 1s the Hne number of the Hne that the 
text block will follow after the move. The Hne number references must be 
offset by commas ",". Your Hne number parameters must specify existing Hnes 
in the text buffer. If any of the entered Hne numbers are non-ex1stant, the 
message, 

No such Hne 

will be displayed. 

"LlneS" is not permitted to equal "Unel" or "I1ne2 , » as that would 
represent an Illogical move operation. "L1ne3" 1s not permitted to be a Hne 
Interior to the range "Unel" through M Hne2' 8 as that would also be an 
Illogical operation. The message, 

Bad paraneter(s) 

will be issued if your input violates any of these conditions. 



block of text to be moved is stored temporarily in the spare text 
region. If this region 1s not large enough to store the block, the message. 

Text buffer full 

will be Issued. Try moving the block in smaller segments. 

Upon completion of the move, all lines in the text buffer will be 
renumbered starting from 100 and Incremented according to the Hne increment 
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currently 1n effect. Renumbering 1s absolutely essential to perform proper 
operation of Editor Assembler commands and so it is done automatically. 

Examples of <M>ove commands: 



M 500,900,1510 



You desire to move the block of text starting at line 500 and ending 
at line 900 to follow line 1510. This command will perform the 
desired operation. 



o 



V 
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RE<I4>UMB£R 



This command is used to re<N>umber the lines of text in the 
Its syntax is: 



text buffer. 



J 



N {I1ne{,1nc» 

line 1$ the new first line number. 

Inc is the new increment. 



i 



The <N> command 1s used to renumber the lines 1n the text buffer. The 
first line 1n the buffer is assigned the number specified as "line". If 
"line" 1s not specified, 1t defaults to 00100. The remaining lines 1n the 
buffer are renumbered according to the Increment "inc" or the previous 
increment in a re<N>umber„ <R>eplace, or <I>nsert command 1f the increment 
was not specified. The current line pointer, ".% points to the same line as 
it did before the re<N>umber command was used, but the actual number of this 
line may be changed. 



Examples of line re<N>umbering: 



This command will renumber the text to start with line number 100. 

The previous increment in effect $11! be usaL 



This re<N>umber command will renumber the text to start with line 
number 5. It also uses the previous increment. 



N10,5 



This command will renumber the text to start with line number 10. It 
changes the line increment to a value of 5. 



y 



7-26 



Editor Assembler Coaaands 
<P>RINT 



The <P>rint command 1s used to display a line or block of lines to the 
video display. Its syntax is: 



P {I1nel{,line2}} | 



llael 1s the number of the first line to display. 



I 



11n@2 1s the number of the last line to display. h 

I 



■■■uvsuatauiaiauuiunau 



The <P>rint command will display a line or a group of lines on the 
monitor screen. The current line pointer, ".", is updated to point to the 
last line displayed. 

If "linel" is entered without entering "I1ne2", then only "linel" will 
be displayed. If neither "linel" nor "I1ne2" are entered, then the current 
line plus 14 additional lines (total of 15) will be displayed (23 total lines 
will be displayed on the Model II). 

"^ Examples of <P>r1nt1ng lines: 

P #,* or P..t,b 

* 

This command will display all lines 1n the text buffer. You may use 
the <PAUSE> function to temporarily halt the display from scrolling. 

P 100,500 

This command displays lines 100 through 500 inclusive. 



This command will display the the line pointed to by the current line 
pointer. Only a single line will be displayed. 



This command displays 15 lines (23 on the Model II) starting with the 
current line. The <P>rint command operates 1n a screen scroll mode. 
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<Q>UERY 



UI1I1I 



On the Model I or III, this command can be used to obtain a directory of 
files stored on a disk. Under LDOS 6.x or on the Model II, <Q>uery is used to 
execute a DOS command. Its syntax is: 

azssassssicsissassussasssssasaisaiasssssssaisiEs^^ssssaaiszuassssa 



Q{d{/ext}} 
d 

/ext 



Model I/III 



is the drive (0-7) for which a directory 
display is desired. 

1s an optional "part-spec" file extension used 
to display only files matching the "ext". 



| LDOS 6.x or Model II 

I Q DOS -command 

I DOSHEOnHnAftd can be any DOS command except COPY or BACKUP 
I 

SHgSJBaasBaisaasaasaaaaaaaasaaaaaaaaasiassaaaaaaasaaaaaaBaaaasBaaaa 

With Model I or III, this command 1s used to display a directory from 
the designated drive. If a drive number 1s not entered, drive will be 
assummed. The "part-spec 8 optional entry can be useful to . isolate the 
directory display to select only those files matching a particular class. For 
example, 1f you only want to display the names of "/ASM" files, the part-spec 
extension should be used. 

Under LDOS 6.x or on the Model II, <Q>uery 1s used to Interface with 
the DOS while in the evironment of the Editor Assembler. Any DOS command can 
be accessed. It is recommended that you not attempt to access the "COPY" or 
"BACKUP" commands due to the possibility of overwriting the Editor Assembler. 

IMPORTANT: NEVER DEPRESS <BREAK> ON THE MODEL II DURING A DOS 
COMMAND EXECUTION. TO BREAK ANY DOS COMMAND, USE THE <ESCAPE> KEY. 

Examples of <Q>uery commands: 



Q DIR 



Ql/CCC 



This LDOS 6.x or Model II <Q>uery command will list the diskette 
directory to the display device. 



This Model I or Model III <Q>uery command will display the names of 
all LC source files stored on drive 1. 



fVtwuftiunir _ ftliGTjy 



7-28 



w 



Editor Assembler Cowands 



<R>EPLACE 



This command can be used to replace a 
automatically enter <I>nsert mode. Its syntax 1s: 



specified text line and 



I 

I R {I1ne{,1nc}} 



I 



line 



1s the number of the line to replace. 
1s the new Increment to be used. 



j Inc 

I 

•■■■■•■■■■»un»M»iuassia>MMUuau»*»«s*u»a« 



'■} 



The <R>eplace command only replaces the one line specified and then 
enters <I>nsert mode. If "line" 1s omitted, then the current line 1s assumed. 
If "line" exists, it is deleted and then <I>nsert mode is entered starting 
with that line number. If "line" doesn't exist, <I>nsert mode is entered just 
as if the <I>nsert command were invoked. If "inc" 1s not specified, the last 
increment specified by in <I>nsert, <R>eplace, or re<N>umber command 1s used. 
The current line pointer, ".", 1s always updated to the new current line. 



If during subsequent INPUT of lines, the error message: 

No wre roos 

is issued, 1t means that a line numbered "current" + "inc" already exists. It 
is suggested that you renumber the lines artd continue your insertion after 
ascertaining the new line number assigned to the "current" line. 

Examples of <R>eplace commands: 



This command will replace the current line. 



R 100,10 



This <R>eplace command will start replacing lines beginning at line 
numbered 100 and enter <I>nsert mode with an increment of 10. 



This command will start replacing at line numbered 100 using the last 
specified increment. 



-S 
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<S>WITCH CASE CONVERSION MODE 



This command 1s used to toggle the "case conversion mode" of EDAS. It ) 
will either permit the acceptance of both upper case and lower case, or 
invoke the automatic conversion of lower case to upper case where required. 
Its syntax is: 



I S 

I 

I There are no parameters or options. 



Conmand <S>witch will toggle the switch-case conversion of lower case to 
upper case. If your computer supports the display of lower case, this feature 
will be of great benefit. Two modes are available: 

1. Lower case accepted: This mode permits entry of either lower case or 
upper case. Your Input is preserved 1n whatever case It 1s entered. EDAS 1s 
suitable as a text editor 1n this mode. This Is the mode used when entering 
LC C-language source text. 

2. Lower case converted: This mode permits entry in either upper case or 

lower case. All lines are converted to upper case during <I>nput mode or when """ 
exiting the <E>d1t mode. This mode should be used to input assembler source 
text. While in the lower case converted mode, the following conversion Y 
behavior 1s exhibited: 

Character strings within single quotes are kept in lower case 1f 
entered 1n lower case. This will ensure that your string declarations 
are kept intact. 

Characters entered following a semi -col on are kept in lower case 1f 
entered In lower case. This permits the entry of comments In lower 
case which makes your source text much more "readable". 

On entry to EDAS, the "lower case converted" mode 1s activated. Each 
entry of an "S" command will switch (toggle) the case mode and an appropriate 
message will be displayed. 

Lowr* case permitted - for full lower case 
Lower case converted - for upper case conversion 

Since the <I>nsert command mode converts to upper case, the <F>ind and 
<C>hange commands utilize the <I>nsert Input and will also convert to upper 
case. You can <F> or <C> lower case by using the case switch toggled to 
"lower case permitted". , Ma 
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<T>YPE 



This command can be used to print a line or block of lines on a line 
printer. In contrast to the <H>ard copy command, <T>ype will omit the line 
numbers. Its syntax 1s: 



T {I1nel{.l1ne2}} 

Unci 1s the number of the first line to print. 

11ne2 1s the number of the last line to print. 

•■■■ii»aiiasaisaaaaaaag Xa i aatisaa] , SBasaaaaaBaBaalaasaala , saal 



I 



The <T>ype command prints a line or block of lines onto the Line 
Printer. The current line pointer, ". M , is updated to point to the last line 
printed. This command is much like the <H>ard copy command, except line 
numbers are not printed. Only the source text 1s printed. If a properly paged 
display 1s desired, It 1s suggested that you set your paper to begin printing 
at the sixth line from the top of the page (for additional Information on 
paging, see the <1> command). 

Examples of <T>ype commands: 

For examples -of the <T>ype command, see the <H>ard copy command. The two 
commands function Identically except that <T>ype omits the line numbers 
during the printing. 
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MEMORY <U>SA6E 



This command 1s used to display certain statistics concerning the memory J 
usage of your source text buffer. Its syntax 1s: 



y 



I 



I 

There are no parameters or options. I 

I 

assv««a*WM«ssasswssi*iBafBasatsm8«sniB9attaacacnn8a8BS8iai<(S8acKnBaaaiaiic«i«i«aiii 

This command will display the number of bytes of text buffer 1n use, the* 
number of bytes spare and the first address available for assembly to memory 
(note that 1f macros are being used, the macro storage area extends from the 
address shown as the first address available for assembly and you will have 
to experimentally choose a higher address for an H 1n-memory" assembly). 

This command 1s useful to ascertain requirements for storing the text 
buffer to disk. Note that a disk file, which 1s ^.^^gu ^ n £$cil 
(un -numbered), will contain two (2) bytes less per text line. The 2 bytes 
represent the line number used in the storage format of text 1n memory versus 
text 1n an un-numbered ASCII file. 

It also 1s useful when assembling into memory. Since the Assembler will 
not permit you to overwrite 1t or the text buffer, you will have to "ORG" 
your program in the free text buffer area. The first available address 1s f 
output by this command (remember the note on macro storage). 

An example of <U>sage output 1s: 

30622 bytes spare 

00000 bytes in use 

8863H is the first free address > 
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<V>XEW 



This command 1s used to list (display) a file on the video display 
device. Its syntax Is: 



V {fllespec} 

fllespec 1s the fllespec of the file to be displayed; 

wuuu«siuimnuurara»a»Muiuiu»ra»«Mu»asw*m 



T? 



This command can be used to display any file without actually loading 
the file Into the text buffer. No attempt 1s made to convert non-ASCII 
characters prior to displaying. Therefore, 1f the file 1s not an ASCII file, 
strange characters maybe displayed. Use the <V> lew command primarily to 
display source files. 

The output may be temporarily stopped by depressing the <PAUSE> key or 
may be interrupted and cancelled by depressing the <BREAK> key. 

If you do not enter the fllespec with the command line, 1t will be 
prompted for with the query: 

fllespec? 

If you "do not enter a file extension with the file specification, a 
default extension of "ASM" will be used unless the "LC" parameter was 
specified when entering EDAS. "LC" redefines the default specification to 
"CCC". Note that the default extension could also have been changed via the 
"EXT»ext" parameter. 
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<W>RITE 



The <W>r1te command is used to save the contents 
a disk file. Its syntax is: 



of the text buffer into 



<■*-» 



W{+M#H$M!hh> {filespec) 

filespec 1s the filespec to be written. 

♦ is an optional switch to write a source file 
created with a header record. 

# 1s an optional switch to write a source file 
with line numbers. 

$ 1s an optional switch to write a source file 

with line numbers terminated by X'89'. 

Ihh is an optional switch to specify a end-of-f1le 

terminating byte of X'hh' other than X'lA'. 
Use "I!" to suppress the E-O-F byte. 

iMm«aawMMaaMaanwaaaaaaaagaaaaaaaaMaMaaaaaaaaanaaaaaaaaaaaaaaaaaa 

This command will write the text buffer to the file denoted by filespec. 
If no filespec 1s entered, you will be prompted for 1t 1n a manner identical 
to the <L>oad command. If you omit the file extension (EXT), a default 
extension of "ASM" will be used thus savins keyboard input and at the same 
time providing for a standard file naming convention. Remember, if you had 
specified "LC" or "EXT»ext" when you entered EDAS, the default source 
extension will be "CCC" or "ext" respectively. 

The switches are used for compatibility In writing source files for use 
with other editors such as the M-80 editor, EDIT80, earlier versions of EDAS 
(3.4 and 3.5), and EDTASM. If more than one switch is used, the order is 
Irrelevant. Use of the switch ■+■ will enable creating a file with a file 
header record (X'D3' followed by a 6-character filename). 

If the source file is to contain line numbers, then the "#" switch 
should be used. This will write line numbers as five ASCII digits with the 
high order bit (b1t-7) set. The line number Is terminated with a space 
character (X'20 1 ). The switch "$" generates a line numbered file the same as 
the ■#" switch; however, the terminating character 1s written as a tab with 
bit-7 set (X'89'). Some versions of FORTRAN require the source file to be 1n 
this manner; thus, EDAS could be used to prepare source files for FORTRAN. 

Finally, the "!hh" switch can be used to specify an end-of-f1le byte to 
be other than the standard X 8 lA' normally used by EDAS. For Instance, 
specifying "!00» will change the E-O-F byte to X'00', the value used by 



./ 
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SCRIPSIT. If Instead of the two-character hexadecimal value, you enter a 
second exclamation point as In "!!", then no E-O-F byte will be written. 
Observe caution as EDAS can only properly load a file 1f the E-O-F byte is an 
X'lA' or an X'00'. 

If the file denoted by "filespec" is non-existant, a file will be 
created and the message, 

New File 

will be issued. If the file denoted by "filespec" 1s an existing file, 1t 
will be replaced by the write operation and the message, 

Replaced 

will be Issued. YOU WILL NOT BE GIVEN AN* OPPORTUNITY TO CANCEL A WRITE 
REQUEST ON AN EXISTING FILE. Know what you are doing. 

Examples of <W>rite commands: 



W parmd1rl:3 



This command will write the current contents of the text buffer to 
the file, PARMDIR1/ASM:3 



W m doparm/jcl:0 



This- <W>r1te command will save the text buffer in the file, 
DOPARM/JCL:0. An E-O-F byte of X«00' would be used Instead of X'lA'. 
Thus, EDAS was used to edit a Job Control Language file. 
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E<X>TEND 

as 81 <ES 33 SS M SB S3 

This command can be used to increase the area of the text buffer by 
eliminating the assembler. Its syntax 1s: 



I X 

I 

I There are no parameters or options. 



This command can be used to extend the text buffer area by moving th€« 
text over the Assembler portion of EDAS in memory. Approximately 8000 bytes 
are gained by this extend operation. It 1s useful 1f you are editing a large 
body of text or are dealing with a large assembly language source program. 
Since the capability of direct assembly from disk files is a function of the 
EDAS Editor Assembler, editing can be performed without the Assembler module 
of the program in memory. You, of course, will have to exit and reload the 

Another reason for the use of e<X>tend, is to handle those EDAS 3.5 
files that now exceed the maximum text buffer size of EDAS version IV. It is 
suggested that you keep your source files 1n smaller modules. The *6ET 
capability provides great power 1n handling multiple source files 1n an 
assembly stream. You will thus find that a program made up of smaller modules 
of code is perhaps easier to maintain and just as fast to assemble. 

Following the entry of the <X> command , the prompt: 

Are you syref 

will be displayed. This is provided as a safeguard in case you inadvertantly 
enter the <X> command. You must respond <Y> in order to complete the 
extension. Entry of any other character will abort the extend operation. A 
response to the query with a <Y> will move the current contents of the text 
buffer and reset all pointers to their proper value. Once the e<X>tend 
command Is Invoked, both it and the <A>ssemble command will be made 
inoperative. 
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<1> (ONE) 



This command can be used to display or alter the current page formatting 
parameters of EDAS. It is not supported under LDOS 6.x or Model II (use Q 
FORMS). Its syntax is: 



l{nl{,n2}} 

nl is the number of lines to print per page. 

nZ 1s the page length in lines. 



This command can be used to alter the two paging parameters used by 
EDAS. One of these parameters specifies how many lines to print on a page 
before issuing a form feed. The other parameter is specified in the printer 
Device Control Block (DCB) and represents the maximum printing lines on a 
page. EDAS initializes with "nl" set to 56 (57 on a Model III since a Model 
III starts counting from 1). Thus, 56 lines will be printed before sending a 
page eject. The value of the page length stored in the *PR DCB (X'4028 1 Model 

"n2" value. Either value can be changed with this 
is entered, then the current values will be 



I and III) is used for the 
-^ command. If no parameter 
displayed. 



Examples of the <1> command: 



1 46 51 



This command will set the maximum page length to 51. The number of 
printed lines until a form feed is generated will be set to 46. 



This command will display the current values for lines-to-print and 
lines-per-page. The display will look like: 



00056 00066 

00057 00067 



(Model I and Model II) 
(Model HI) 
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MESSASE TO JOB LOS "." 



The dot "." command can only be used with LDOS, to post a time-stamped 
message to an active job log. There will be no visual indication of the 
event. Its primary utility will be with Job Control applications of EDAS. An 
example of a message post would be: 

. Starting assembly of PARMDIR 
SCROLL UP <UP»ARR0W> 

The "SCROLL UP" command displays the line preceding the current line ari*d 
updates the current line pointer,, ".", to point to the line displayed. If the 
current line is the first line in the text buffer, it 1s displayed and period 
"." remains unchanged. "SCROLL UP" is an immediate command and must be the 
first character of a command line in order to be Interpreted. 

SCROLL DOWM <ooy^-ARROy> 

•Bassaaaaasaassassasasss 

The "SCROLL DOWN" command displays the line following the current line 
and updates the current line pointer; ".", to point to the line -displayed. If 
the current line 1s the last line 1n the text buffer, the last line Is 
displayed and period ■•■ remains unchanged. "SCROLL DOWN* is an Immediate 
command and must be the first character of a command line to be interpreted. // 

CLEM SCREEN <SHIFT-CLEAR (Model I/III)> <F1 (Model II )> 



The <CLEAR> key is used to perform a functional clear screen and display 
of the Initial entry massage. The "CLEAR" function also performs a <8R£AK> 
operation but cannot be used to interrupt output. This function is identical 
to a warm-start of EDAS and will reset automatic line numbering to its 
intital value of m. 

On the Model I and Model III, the <SHIFT-CLEAR> key performs the "clear" 
function. The <F1> key is used on the Model II. Consult your DOS manual for 
the appropriate key under LDOS 6.x. 



X 
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PAUSE <SHIFT-« (Model I/III)> <H0LD (Model II )> 



The <PAUSE> key is used to pause the computer during a display, during 
any assembly, or Editor Assembler printing. When a pause is sensed, 
depression of any key except <PAUSE>, <SHIFT>, or <C0NTR0L> will continue the 
operation paused. It is only necessary to momentarily depress the key as a 
pause function will be held pending as soon as the key is pressed. On the 
Model I and Model III, the <SHIFT-@> key 1s used as a "pause". The <H0LD> key 
1s used for this purpose on the Model II. 

BREAK ^ 



The <BREAK> key 1s used to terminate the <I>nsert mode. It is also used 
to abort an assembly in effect. It will also abort any disk I/O operation or 
display listing. A detected <BREAK> will return EDAS to the command ready 
prompt, ">". 

PASE FORWARD <SHIFT RT-ARROW (Model I/III)> <F2 (Model II )> 



The <SHIFT-RT-ARRQW> key on the Model I and Model III 1s used to advance 

the display by 15 lines. The <F2> key is used on the Model II to advance the 

^ display by 23 lines. This command is similar to the <P>r1nt command except 

- that the display screen is cleared prior to displaying the 15/23 lines of 

source text. " 

USER PATCH SPACE - ZCMO 



A 50-byte patch space is available for your use. A vector pointing to 
this space is located at X'5809' (Model I/III), X'3609' under LDOS 6.x, or 
X'3709' (Model II). If you place a routine in this space, it can be executed 
by entering a <Z> at command ready. The space currently has a RET instruction 
as the first byte which is used to return from the <Z> command. 
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XREF 



The MISOSYS XREF utility is used to generate a cross reference listing 
of symbols used in your source code. Its syntax is: 



XREF f1lespec/REF {(LEN»val,PAGE»val,LINES»val,EQU,LIMIT)} | 

fllespec 1s the specification of the reference data | 
file generated by the -XR switch of EDAS. If | 
the file extension is omitted, M REF" is used. * j 



V 



I 



LEN 1s the length of your print line (the default i 

value Is 80). j 

PAGE is the maximum number of lines per page (the I 

default is 66 for Mod I & II, 67 for Mod III). | 

LINES is the number of lines to print on a page (the | 

default is 56 for Mod I & II, 57 for Mod III). | 

EQM is used to generate a file of EQUates instead I 

of the cross reference listing. j 

LIMIT 1s used to limit the file of EQUates to those I 

symbols containing a special character. j 



I Note: the format of "value" is PARM»ddd or PARM»X'hhhh'. 
PAGE and LINES are not supported under LOOS 6.x or Model II 
There are no parameter abbreviations. 




The XREF/CMD utility generates a symbolic cross-reference listing which 
includes a sorted 11st of all defined labels, the file of origin of the 
definition, the line number of the definition, the value of the definition, 
X«EXu.!!f, numbers of a11 statements referencing the label. If »*GET" or 
*5EARCH files are used in the assembly process, XREF will even identify the 
filename of the file containing the references. XREF will not identify 
unresolved labels. Therefore, make sure that either all labels are resolved 
during the assembly that generates the XREF data file, or you do not need the 
line numbers of those unresolved references appearing in the cross reference 
listing. 

XREF can also be used to generate an assembler source file of EQUates of 
all symbols used in the program being assembled or a subset of all symbols 
used. The LIMIT parameter is used to limit the EQUates to only those symbols 
having at least one special character in the symbol name. 
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XREF uses, as Input, the reference data file which Is optionally 
generated by the -XR switch during the LISTING pass of EDAS (phase 2). XREF 
cannot function without this data file. You need not enter the file 
extension, /REF, as It will be assumed 1f omitted. 

The XREF command line parameters enclosed in parentheses are entirely 
optional. The may be used as follows: 

LEN 

This parameter controls the printed line length during the XREF listing. 
If omitted, a value of 80 1s assumed to deal with 80-column line printers. If 
you are using a wide-carriage printer (typically 132 columns), then XREF can v 
use the entire print line by specifying the parameter as: 

XREF (LE84»132) 

PAGE 

This parameter controls the page size. A value of 66 lines per page (67 
on the Model III due to its line counter starting from 1 Instead of 0) is 
used. If your paper 1s shorter or longer, you can respedfy the page length 
from the command line. For Instance: 

XREF fllespee (PflSE*51 9 LIWES»41) 

will set the page length to 51 lines per page and Initialize to print 41 
lines. 

LINES 

This parameter controls the quantity of lines printed on a page before a 

page eject (form feed) is generated. If omitted, a value of 56 printed lines 

is used. You can respecify the quantity of lines you want printed by a 
command similar to that shown for the PAGE parameter, 

EQU 

This parameter controls the generation of the EQUate file. If this 
parameter 1s entered, then the cross reference listing 1s suppressed and a 
source file of symbols equated to their value 1s generated. The filespec used 
to write the EQUate file will be constructed using the filename and drive 
specification of the VREF" file. A file extension of VEQU" will be used. If 
this parameter 1s entered, then LEN, PAGE, and LINES will be Ignored. 

Symbols defined by the "DEFL" pseudo-OP will be maintained as OEFL's 1n 
the EQUate file. The file will be created without a header and without line 
numbers - 1t will be a standard EDAS Version IV file. 
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^ 



LIMIT 



This parameter controls what symbols are written to the EQUate...flJe.-lf_ 
entered 1n addition to the "EQU" parameter, then the EQUate file will be 
limited to those symbols that contain at least one special character (a 
character other than A-Z, 0-9). 



Cross-Reference Listing 



\ 



The listing requires two passes through the data file. This 1s 'done to 
conserve memory space so that listings for extremely large programs can be 
processed. If you are generating the cross reference listing, three 
informative messages will be displayed prior to generating the printer 
output. "Building symbols declared" will be displayed during the first pass 
through the data file as XREF creates a table of information pertinent to all 
symbols declared. After this table is completed, the message, "Sorting symbol 
table" will be displayed. The operation being performed 1s self evident. A 
second pass through the REF data file will be made while the message, 
"Building symbols referenced" is displayed. This pass is used to create a 
second table of information pertinent to all references to symbols. 

The listing will contain a heading on each page. This heading 1s 
composed of the system DATE and TIME, the TITLE extracted from the source 
code 1f a TITLE pseudo-op was used In the assembly process, and a page 
number. The heading line requires a minimum of 74 columns. Thus, 1f you 
specify a LEN parameter of less than 74, the heading will either wrap around 
on your printer or be truncated - depending on how your printer handles 
longer lines. The reference columns will include: 

Origin 



The filename of the file containing the declaration 
the symbol was declared by a statement located 1n memory, 



Otherwise, the 

M 



listed as "$MAIN' 

fllespec" or "*SEARCH library 

Symbolic Label 



of the symbol. If 
the ORIGIN will be 



ORIGIN will list the filename of the "*GET 



This column contains the symbol name of the declaration. If the 
was defined by a "DEFL" pseudo-OP, a plus sign, "+", will precede the 
name to denote this fact. - references will only be printed against 
the label definitions; however, all declarations will be shown. If the 
name was actually the name of a MACRO, it will be prefixed by a pound 
"#" and the "value" field will be irrelevant. The symbolic labels are 
in ascending alphabetical order. 



symbol 
symbol 
one of 
symbol 
sign, 
sorted 
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Value 



This column contains the value of the symbol as determined during the 
assembly process. If the symbol shows a DEFL' definition, the value will be 
the first defined value. If a MACRO name 1s Indicated, the value shown 1s 
actually the storage location of the MACRO prototype and model - it will 
serve no useful purpose. 

L1ne# 

This column contains the line number of the source line declaring or 
defining the symbol. The symbol 1s defined where the symbolic name 1s used jn 
the label field of a source statement. " 

Usage 

This column contains the filename of the file containing a reference to 
the label. If the label 1s referenced from a statement resident In memory, 
then the filename will be listed as SMAIN. Otherwise It will be the filename 
field of the *GET fllespec pseudo-OP fetching the file or the library 
fllespec If a *SEARCH was Involved. 

L1ne# of References 

mm «» *» m m m •»*»«» *» «b m «• «■ aw m «s «n at 

All references to the label will be listed 1n this field. It will 
contain the line number of the source statement containing the reference. All 
of the references listed on a print line will be contained In the file 
Identified under the usage column. Whenever the Usage file changes, 1t will 
cause a new line to be generated 1n the listing. 

Statistics 

At the conclusion of the cross reference listing, two additional Items 
of Information are listed. The quantity of symbols declared 1s listed along 
with the quantity of references associated with those declarations. 



J- 
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The MISOSYS TTD utility is used for transferring to disk, a source 
cassette file that was created with the Radio Shack EDTASM, Microsoft 
EDTASM+, or other compatible editor assembler. TTD is not supported under 
LDOS 6.x or on the Model II. 

To execute the TTD utility, at your DOS ready, simply use the syntax: 



"^ 



V. 



! TTD C:d} ! 

SUIUMSnUUIUIIUIIUaUUIIIHIIUMIIUMIIIIlllluilili 

TTD is used to transfer a source cassette file to disk. The filespec 
will be constructed using the filename found on the cassette tape file and 
the file extension "/ASM". If the optional drive specification, M :d" (where 
M d" is the drive number of the drive receiving the disk file), is entered 
with the TTD command line, it will be used in the construction of the file 
specification. 

TTD will prompt you to ready the cassette via the message: 

Ready cassette and <ENTER> -> for a Model I 
Ready cassette and enter <H,L> -> for a Model III 

The <H,L> entry for Model III users will select either High speed cassette 
operation (15(30 baud) or Low speed cassette operation (500 baud). Respond to 
the prompt by depressing the <ENTER> key if you are a Model I user, or the 
correct baud rate character if you are a Model III user. 

The cassette source file will be transferred to disk. TTD will then 
return to DOS. 
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GENERAL 



EDAS Version IV recognizes three types of errors. These are: 



'? 



Cooaand This 1s an EDAS command syntax error. The 
error message 1s displayed and control 1s 
returned to command mode. 

DOS This. 1s an operating system disk I/O error. 
The error message is displayed and control 1s 
returned to command mode. 

Assembler These errors may occur while executing an 
Assemble command. There are three types: 
terminal, fatal, and warning. 

asaaaaaaaaassaaaaaaaasaaaasxsaaasaaaaasaaaaaaasssassaaaaaassasastaaaaaa 

DOS disk I/O errors can also be received during an assembly. When a disk 
I/O error occurs, the assembly will be aborted and control will be returned 
to EDAS command ready. 



Three different types of assembler errors can occur, 
the severity of the error. These types are: 



The types relate to 



Terrain*! Assembly is terminated and control is returned 
to command mode. 

Fatal Processing of the line containing the error 1s 
Immediately stopped and no object code 1s 
generated for that line. Assembly proceeds 
with the next statement. 

The error message 1s displayed and assembly of 
the line containing the warning continues. The 
resulting object code may not be what the 
programmer intended. 



■aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 
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Error Messages 
Following 1s a list of all error messages and an explanation of each. ""\ 
COMMAND ERRORS 



l.> Buffer full 

There Is no more room 1n the text buffer for adding text. 
2.> Bad parameter(s) 

Any command line not entered according to the syntax appropriate 'for 
that command will generate this error message. Also, if you attempt to load a 
file that is not a valid source code file, this message may he displayed. The 
<K>111 command requires entry of a filespec, which if omitted, will also 
display this error message. 

3.> Illegal command 



The first character of the command line entered does not specify a valid 
Editor Assembler command. 

4.> Line number too large 

Renumbering with the specified starting line number and Increment would 
cause I1ne(s) to be assigned numbers greater than 65529. The renumbering is 
not performed. This message would also be displayed if you attempted to 
INSERT a line with a line number exceeding 65529. 

5.> No room between lines 

The next line number to be generated by INSERT or REPLACE would be 
greater than or equal to the line number of the next line of text 1n the edit 
buffer. The Increment must be decreased or the lines in the buffer 
renumbered. 

6.> No such line 

A line specified by a command does not exist. The command 1s jiot 
performed . 
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7.> No text in buffer 



A command requiring text in the buffer was issued when the text buffer 
was empty. The commands <L>oad, <I>nsert, <Q>uery, <S>witch, <B>ranch, 
<U>sage, <V>iew, e<X>tend, <K>ill 9 Dot <•>, <Z>, and ONE <1> can be executed 
when the text buffer is empty. All other commands require at least one line 
of text to be in the buffer. 

S„> String not found 

The string being searched for by the <F>ind command could not be? found 
between the current line and the end of the text buffer. This message will 
also be displayed at the completion of a global change command. 

DOS ERRORS 

SB SB SS 3 3ES S3S 3E SS 

The standard DOS error messages will be displayed if the DOS returns an 
error code after return from any disk operation. Consult your DOS operating 
manual for explanations of those errors. During most error handling, the 
abbreviated form of the error message will be displayed. If an I/O error is 
detected during an assembly, the long form of the error message will be 
displayed. This provides an observance as to which file was affected by the 
v,. I/O error. 

Any attempt to load or *GET a file that has a line longer than 128 
characters will result in "Load file format error". 

TERMINAL ERRORS 

uaausimain 

l.> Memory overlay aborted 



During an assembly to memory, a block of code was assembled that would 
load into a memory region other than the spare text buffer area. Your program 
will not be permitted to load to an address below the end of the text buffer 
or above the symbol table. Use the Usage command to locate the first 
available memory address. If you are using MACROS, the first available memory 
address is indeterminate as the MACRO processor uses the memory area 
immediately following the text buffer for a MACRO model and string buffer 
storage area. 

2.> Symbol table overflow 



•«•*••« «* m 



There is not enough memory for the assembler to generate your program's 
symbol table. You have three options: 
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l.> Remove comment lines and/or comments following Z-80 code 
operands. This may free up enough space to perform the assembly. 

2.> Divide your program into two or more modules and assemble them 
using the *6ET filespec directive. 

3.> Extend the text buffer area 9 expand your source, then assemble it 
using the *GET filespec directive. 

3.> *6ET or *SEARCH error 

A "*GET filespec" or M *SEARCH library" assembler directive was found in 
a library member. A searched library cannot have "*SETs" or nested 
M *SEARCH@s\ /, 

4.> Member definition error: f1lespec( member) 

This Is a result of a fetched ^SEARCH member not resolving the symbol 
reference Invoking its fetch. 

FATAL ERRORS 

UCHIMSIU 

l.> Bad label 



«»<«>co«t>«i»«»wan«Bl 



The character string found in the label field of the source statement 
does not match the criteria specified under ASSEMBLY LANGUAGE INFO - LABELS. 

2.> Expression error 

The operand field contains an 111 -formed expression. 
3.> Illegal addressing mode 

The operand field does not specify an addressing mode which Is legal 
with the specified OPCODE. 

4„> Illegal opcode 

The character string found fn the opcode field of the source statement 
is not a recognized instruction mnemonic, assembler pseudo-op, or MACRO name. 



:' - MESSA6ES 
10 - 4 



^ 



Error Messages 
5.> Missing Information 



Information vital to the correct assembly of the source line was not 
provided. The OPCODE is missing or the operands are not completely specified. 

6.> Too many nested *GETs 



*GET filespec nesting exceeds the number of levels supported. The *S£T 
m111 be Ignored. 

7.> Unclosed conditional /? 



The "END" statement or end of source was reached and an open "IF" 
conditional block was still pending. Your program 1s missing the closing 
"ENDIF". 

8.> ENDIF without IF 



An "ENDIF* pseudo-op was detected without a corresponding conditional 
"IF" or "IFxx" 1n effect. The "ENDIF" will be ignored. 

9.> ELSE without IF 



An "ELSE" statement was detected without a preceding "IF" conditional 
segment. 

10. > Filespec required 



A *GET or *SEARCH directive was detected but the statement did not 
contain the required file specification. The *GET or *SEARCH will be ignored. 

11. > Bad parameter(s) 



When output preceding a MACRO definition, 1t Implies an error 1n the 
parameters of a MACRO. 

12. > Nested MACRO Ignored 

A macro definition statement was nested in the model of another macro. 
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13. > Missing MACRO name 

The name field of the macro definition statement did not contain the 
macro name. The macro will not be defined. 

14. > ENQM without MACRO 

An ENDM pseudo-OP was detected while not in a macro definition phase. It 
will be ignored. 

15. > Too many parameters 

'v 
In a macro call, the number of parameters passed exceeded the number 
defined for the macro. The macro call will not be expanded. 

16. > Too many nested MACROS 

The number of pending nested macro calls exceeds the current nest level 
supported. The macro call will not be expanded. 

17. > MACRO forward reference 

A macro call was detected prior to the definition of the macro. The 
macro call will not be expanded since gross phase errors would result. 

18. > Multiply defined MACRO 

A macro definition statement was detected for a macro already defined. 
The subsequent definition will be Ignored. 

UARNINSS 

l.> Branch out of range 

The destination of a relative Jump Instruction (JR or DJNZ) 1s not 
within the proper range for that instruction. The instruction Is assembled as 
a branch to itself by forcing the offset to hex X'FE'. 

2.> Field overflow 

A number or expression result specified 1n the operand field Is too 
large for the specified instruction operand. The result 1s truncated to the 
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Error Messages 

~\ largest allowable number of bits. This error would also be output during 
global change 1f a resultant line would exceed 128 characters. 

3.> Multiply defined symbol 



-_-' 



The operand field contains a reference to the symbol which has been 
defined 1n another line. The first definition of the symbol 1s used to 
assemble the line. 

4.> Multiple definition 



The source line is attempting to illegally redefine a symbol. The 
original definition of the symbol 1s retained. Symbols may only be redefined 
by the OEFL pseudo-OP and only 1f they were originally defined by DEFL 

5.> No END statement 



The program ENO statement 1s missing. Note that if your program is 
missing the "END" statement, EDAS cannot detect an unclosed conditional. 
Also, be aware that 1f your program has a FALSE unclosed conditional, then 
the "END" statement will NOT be detectable - even 1f present. 

6.> Undefined symbol 

The operand field contains a reference to a symbol which has not been 
defined. A value of zero is used for the undefined symbol. 
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Technical Specifications 
OBJECT FILE FORMAT 



The disk file object code format consists of a header record, an 
optional comment record, one or more load block records, and a transfer 
address record. The specific formats of these records are as follows: 

Header Record 



The file header record consists of the hex byte X'OS' (record type) 
which indicates the header field of an object file. It is followed by the 
header length byte which indicates the length of the header data foljowlng. 
The length of the header data 1s constant in EDAS and 1s six bytes. The data 
Is constructed as the first six bytes of the object code file name field and 
is filled out with spaces 1f the file name 1s less than six characters. 

Comment Record 



This record 1s optional. It 1s generated by the "COM" pseudo-OP. It 
consists of a record type byte of X'lF' followed by a length byte which 1s 
the length of the comment. The comment data, Itself, follows. 

Load Block Record 



The load block record starts with a record type code of X'{J1* which 
indicates 1t ' 1s a load block. A 1-byte length 1s next. This Indicates the 
length of the object code data plus the 2-byte block load address. The length 
is encoded as a modulo 256 value (object code length of 253 * X'FF', object 
code length of 254 » X'00', object code length of 256 will show as X'02'). 

The block length byte is followed by the 2-byte block load address which 
1s the address that will be loaded with the first byte of the block. 

Finally the object code block Immediately follows for as many bytes as 
two less than the block length. 

Transfer Address Record 



The Transfer address record (TRAADR) starts with a record type of X'02'. 
?? S 9 K I? ^l l l en J? Indicate the length of the entry point address. This 
ll TV followed h y tn e 2-byte entry point or transfer address generated from 
the label or constant 1n the operand field of the assembler source END 
statement. As 1s the case with all 16-bit data values, the TRAADR data has 
the low-order byte of the address followed by the high-order byte. 
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Technical Specifications 



SOURCE FILE FORMAT 
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The source code file format used by EDAS has no header nor line numbers. 
Headers and numbers are entirely optional and can be generated with 
appropriate switches in the <W>rite command. The formats are as follows: 

Header Record 



A header record as described under "Object file format" is optionally 
used for source files with the exception that the first byte is a hex X'D3' 
(X'53* - with bit 7 set) to identify the file as source, immediately followed 
by a 6-character name (the name length byte Is omitted). Files written with 
M W+" contain this header. ^ 

Text Lines 

Text lines are written in ASCII each composed of an optional 5-character 

line number (bit 7 is set), a space, the text Hue, ending with an <ENTER> 
(X'0D' ). Files written with the "Wf cowand incorporate both the S^character 
line number and following space. 

End-of-File Hark 

The file end is Indicated by an end-of-file mark of X'lA' which would be . t 

in the first character position of a text line (or 1st byte of the 'line 
number 1f line numbered files are used). 

REFERENCE DATA FILE FORMAT 

casssiaiaasnaiisssausiiaB 

The reference data file is a compressed collection of data corresponding 
to each symbol definition and reference. The file contains a title record, 
and definition/ reference records. The format of these records Is as follows: 

Title Record 

The title record is always present even though the assembler source file 
stream may or may not have supplied a TITLE pseudo-QP. The title record Is 28 
characters long. If the source files did hot contain a TITLE pseudo-OP, the 
record will be filled with spaces. 

Definition/Reference Records 

These records contain the data for either a symbol definition or 
reference. It is composed of a filename field, a line number field, a type 
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Technical Specifications 

field, a value field (omitted for references), and a symbol name field. These 
fields are defined as follows: 

Filename Field 

This field will be either an eight character filename or a hex X'22'. If 
a hex X'22' t then the filename reference 1s the same as the previous record. 

Line Number Field 



This field contains the line number of the definition or reference 
statement 1n low-order high-order form. 

Type Field 



The type field contains an X'00' for a reference, an X'01' for a 
definition, or an X'02' for a DEFL defined symbol. 

Value Field 



The value field contains the defined value of the symbol. This field 1s 
omitted for references (type field » 0). 

Name Field 



The name field contains the symbol name. It is terminated with a 
carriage return (X'0D'). If the symbol is the name of a macro, the first 
character of the name has the high-order bit set. 
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Technical Specifications 
LINKAGE TO DEBUGGING (Model I/III or LOOS 6.x only) 

■sBaaasssasssssssiaasssaaasBsasasassssssassiassasss 

In order to facilitate the debugging of user generated programs, a 
number of features have been built into EDAS. It provides the option of 
assembling source code directly to memory. It provides a command to transfer 
control to a user-supplied address (via the <B>ranch command). 

A re-entry address to the Editor Assembler has been provided. If at any 
time during the debugging phase, you want to return to the Editor Assembler 
without reinitializing it (which would have deleted the entire text buffer), 
and are under the control of a debugging utility that does not utilize memory 
from X'5400' (X'3200' under LOOS 6.x) to the protected HIGHS, Issue a jump 

command to X'5803* (X*3603* under LDOS 6.x). Alternately, you can provide a 
M JP 5803H" (or JP 3603H under LDOS 6.x) 1n your program as an exit and return i 
to EDAS. A return to the Editor Assembler will be performed and the text 
buffer pointers will be maintained. If your program has maintained the 
Integrity of the stack pointer, a RET instruction will return to the EDAS 
command prompt as the top of the stack contains the prompt address when an 
exit is made via the M B" ranch command. 

EDAS disables the automatic entry to DEBUG on <BREAK> to avoid 
inadvertantly entering DEBUG by depressing <BREAK> to exit an <I>nsert or 
abort an assembly. In order to enter DEBUG directly from EDAS, perform a 
<B>ranch command to address X'SJS 1 .. • - 

0> 
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LC 1.1 Errata - 07/01/83 

1.0 - cursor() 

Correct the syntax of cursor() on page 4-34 and Appendix B-l to read 
cursor (col, row); 

2.0 #option errormsg "'" ' 

Reference the additional option, "errorcsg" on pages 3-8 and 5-1/5-2. 
This option permits you to suppress the automatic display of operating system 
error messages generated on file I/O errors and generally displayed by the 
DOS ©ERROR routine. Suppress the display by specifying "#option errormsg 
OFF". The default of errormsg is ON meaning system error messages will be 
displayed. 

3.0 #option getnl ' ' v 

Reference the additional option, "getnl" on pages 3-8 and 5-1/5-2. This 
option refers to the handling of the newline character (\n) within the 
fgetsO function. According to K&R, the newline should be included in the 
buffer returned by fgetsO. Under LC 1.0, newline was stripped from the 
buffer. LC 1.1 has been brought into agree-ent with K&R on this point.. Jf 
"loption getnl OFF" is specified, then fgetsO will strip the newlirte as 
under LC 1.0. If you have programs compiled under 1.0 that require the 
newline be stripped, you can either reprogram your C source to coincide with 
the language as K&R specify, or you can specify the option as shown. 

4.0 automatic variables 

Automatic ..variable names may be re-used within a nested block. LC 1.0 
did not support this although the LC manual did not reflect the limitation. 
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